{"uid":"cap_kY43YKs7IxGjOx4PJT9p-","slug":"x4o2-stonkfun-token-markets-lookup-5baeb035","name":"x4o2 StonkFun Token Markets Lookup","description":"Exact token markets and freshness","url":"https://stonk.x4o2.com/v1/tokens/:mint?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":{"kind":{"enum":["launchlab","cpmm","amm-v4"],"type":"string","description":"Pool program"},"pool":{"type":"string","description":"Exact pool address; required for candles"},"limit":{"type":"integer","default":20,"maximum":100,"minimum":1,"description":"Page size"},"offset":{"type":"integer","default":0,"maximum":250000,"minimum":0,"description":"Offset"},"lifecycle":{"enum":["bonding","migrating","graduated"],"type":"string","description":"Lifecycle"},"quoteMint":{"type":"string","description":"Exact quote mint; required for ranking or candles"}}}},"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"],"items":{"type":["object","null"]}},"limit":{"type":["number","null"]},"total":{"type":["number","null"]},"offset":{"type":["number","null"]},"partial":{"type":["boolean","null"]}}},"meta":{"type":["object","null"],"properties":{"ageMs":{"type":["number","null"]},"source":{"type":["string","null"]},"partial":{"type":["boolean","null"]},"commitment":{"type":["string","null"]},"observedAt":{"type":["number","null"]},"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_n106tPUyrHgylGgmgcifE","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":"Returns exact token market data, pool listings, and freshness metadata for a given Solana token mint address","exampleAgentPrompt":"Pull the on-chain market data for Solana token mint So11111111111111111111111111111111111111112 — I want to see its pools filtered to the graduated lifecycle using the amm-v4 program, with up to 50 results.","exampleUseCases":[{"title":"Monitor token graduation status","prompt":"Check whether the Solana token with mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v has graduated from its bonding curve yet — pull its current lifecycle and pool info from on-chain data."},{"title":"Research new launchlab token pools","prompt":"Give me the first 20 pools for Solana mint DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263, specifically from the launchlab program — I want to see freshness info too so I know how current the data is."},{"title":"Track migrating token with specific quote","prompt":"Look up on-chain pool data for token mint Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB paired with the USDC quote mint, and only show me pools in the migrating lifecycle stage."}],"resultDescription":"A JSON object containing paginated pool/market data for the queried mint (items array, total count, limit, offset, partial flag) plus metadata about data freshness (ageMs, freshnessSeconds, observedAt, discoveryAt, source, commitment level, partial flag).","failureModes":["Invalid or non-existent mint address returns empty data or 404","Missing required quoteMint when using ranking or candles mode","Missing required pool address when requesting candle data","Offset exceeds maximum of 250000 resulting in empty page","Invalid lifecycle or kind enum values causing 400 error","Data may be partial if ingestion is lagging (partial flag set to true)","Payment not processed results in 402 response"],"whenToPreferThis":"Use this endpoint when you need on-chain market and pool data for a specific Solana token mint, particularly on the StonkFun/LaunchLab ecosystem. Prefer it over generic DEX aggregators when you need freshness metadata (ageMs, freshnessSeconds), lifecycle filtering (bonding/migrating/graduated), or pool-program-specific filtering (launchlab, cpmm, amm-v4). Best suited for agents monitoring meme coin launches and graduation events on Solana.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:34:35.970Z","isFirstParty":false,"canonicalSlug":"x4o2-stonkfun-token-markets-lookup-5baeb035"}