{"uid":"cap_W7d4EXoTLYbE5ZY8eZJO3","slug":"x4o2-stonkfun-spl-token-burns-d09a9405","name":"x4o2 StonkFun SPL Token Burns","description":"Observed SPL token burns; incomplete history","url":"https://stonk.x4o2.com/v1/tokens/:mint/burns?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["mint"],"properties":{"mint":{"type":"string","description":"Exact Solana token mint"}}},"queryParams":{"type":"object","required":[],"properties":{"limit":{"type":"integer","default":20,"maximum":100,"minimum":1,"description":"Page size"},"offset":{"type":"integer","default":0,"maximum":250000,"minimum":0,"description":"Offset"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":["object","null"],"properties":{"data":{"type":["object","null"],"properties":{"mint":{"type":["string","null"]},"items":{"type":["array","null"]},"limit":{"type":["number","null"]},"offset":{"type":["number","null"]},"partial":{"type":["boolean","null"]},"totalBurned":{}}},"meta":{"type":["object","null"],"properties":{"ageMs":{},"source":{"type":["string","null"]},"partial":{"type":["boolean","null"]},"commitment":{"type":["string","null"]},"observedAt":{},"discoveryAt":{"type":["string","null"]},"freshnessSeconds":{"type":["number","null"]}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LLREgEvkDAb5hpqHYeeYv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves observed SPL token burn events for a given Solana token mint address, paginated, with partial-history caveat","exampleAgentPrompt":"Pull the burn history for Solana token mint So11111111111111111111111111111111111111112 — give me the first 50 burn events so I can see how much supply has been destroyed.","exampleUseCases":[{"title":"Deflationary token supply audit","prompt":"I need to know how many tokens have been burned so far for mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v — can you pull the burn records from StonkFun and show me the total burned and the most recent events?"},{"title":"DeFi analytics dashboard burn feed","prompt":"For my dashboard I want to page through all burn events for mint DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263, starting at offset 100 and returning 100 records at a time."},{"title":"Alerting on abnormal burn spikes","prompt":"Check StonkFun's on-chain data for burn events on mint mSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So and tell me if the partial flag is set, so I know if the history is incomplete."}],"resultDescription":"A paginated list of observed SPL token burn events for the requested mint, including each burn item's details, cumulative totalBurned amount, pagination metadata (limit, offset), a partial boolean indicating incomplete history, and freshness metadata (ageMs, observedAt, discoveryAt, freshnessSeconds, commitment level, source).","failureModes":["Invalid or unknown mint address returns empty data or 404","partial:true flag indicates burn history is incomplete — not all burns may be indexed","offset exceeds 250000 cap causing parameter validation error","limit outside 1–100 range rejected with validation error","Stale data if freshnessSeconds is high — on-chain state may have advanced","Payment failure (x402) if USDC not available — endpoint requires $0.001 per call"],"whenToPreferThis":"Use this endpoint when you specifically need historical SPL token burn events on Solana for a known mint address and can tolerate potentially incomplete history (partial flag). It is purpose-built for StonkFun/Stonk platform tokens and provides freshness and commitment metadata. Prefer alternatives if you need real-time streaming burns, complete guaranteed history, or data outside the Solana/SPL ecosystem.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:30:29.827Z","isFirstParty":false,"canonicalSlug":"x4o2-stonkfun-spl-token-burns-d09a9405"}