{"uid":"cap_lkVqEHwdjBYeFKzp3L2Tq","slug":"x4o2-stonkfun-on-chain-market-pools-lookup-a52ee03b","name":"x4o2 StonkFun On-chain Market Pools Lookup","description":"Pools by exact token/quote and lifecycle","url":"https://stonk.x4o2.com/v1/markets?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":[],"properties":{}},"queryParams":{"type":"object","required":[],"properties":{"kind":{"enum":["launchlab","cpmm","amm-v4"],"type":"string","description":"Pool program"},"mint":{"type":"string","description":"Exact Solana token mint"},"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":{"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_rIyvfPRAOcG8j-jE9TqL5","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 paginated on-chain liquidity pool listings filtered by token mint, quote mint, pool program kind, and lifecycle stage on Solana","exampleAgentPrompt":"Show me all graduated LaunchLab pools on StonkFun for the Solana token mint So11111111111111111111111111111111111111112, using a page size of 20.","exampleUseCases":[{"title":"Track bonding curve pools for a meme coin","prompt":"Pull up all the bonding-stage pools for Solana token mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v on StonkFun — I want to see how many are still in the bonding phase."},{"title":"Audit graduated CPMM pools by quote mint","prompt":"List me the first 50 graduated CPMM pools on StonkFun that use So11111111111111111111111111111111111111112 as the quote mint so I can check their migration status."},{"title":"Browse all amm-v4 pools for a token","prompt":"Get me all amm-v4 pools on StonkFun for token mint DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263, show 100 per page starting from offset 0."}],"resultDescription":"A paginated JSON object containing an array of on-chain pool records matching the filters, along with total count, page limit and offset, a partial-result flag, and metadata including data age in milliseconds, observed-at timestamp, Solana commitment level, and discovery timestamp.","failureModes":["Missing required parameters for candles (pool and quoteMint must both be provided)","Invalid mint address format returns empty results or error","Offset exceeding 250000 rejected by schema validation","No pools found for the given filter combination returns empty items array","Rate limit or payment failure (x402 micropayment not processed) blocks the response","Lifecycle or kind enum value typo causes 400 bad request"],"whenToPreferThis":"Use this endpoint when you need to discover or enumerate Solana liquidity pools on the StonkFun/x4o2 platform filtered by exact token mint, quote mint, pool program type, or lifecycle stage. It is ideal for agents doing on-chain market discovery, lifecycle tracking (bonding vs graduated), or building pool directories. Prefer this over generic DEX aggregators when you specifically need StonkFun on-chain data with freshness metadata and Solana commitment signals.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:39:36.538Z","isFirstParty":false,"canonicalSlug":"x4o2-stonkfun-on-chain-market-pools-lookup-a52ee03b"}