# StonkFun On-chain Data API > Independent finalized Solana LaunchLab discovery, exact token/quote/pool markets and OHLCV. Partial coverage; quote-unit prices, unknown USD values are null. GeckoTerminal AMM candles and ingested swap candles. Free key from https://x4o2.com/keys or 0.001 USDC per call via x402 on Base (eip155:8453) or Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp). No StonkFun website/API or Stonk Radar runtime dependency. ## Documentation - [OpenAPI](https://stonkfun.x4o2.com/openapi.json): Machine-readable route definitions - [Complete documentation](https://stonkfun.x4o2.com/llms-full.txt): Parameters, schemas and captured examples - [API keys](https://x4o2.com/keys): Free access - [30-day pass](https://x4o2.com/pass): Higher limits ## Access and limits Free API key: https://x4o2.com/keys; Authorization: Bearer x4o2_… . Free access allows 60/minute and 1000/UTC day per service while spare capacity is available. 30-day pass: 10 USDC, 300/minute and 10000/UTC day per service, independent of free-tier pauses. POST https://x4o2.com/v1/pass with x402. Renewal extends from the later of expiry or purchase time. Wallet signing retrieves a replacement key at https://x4o2.com/pass; previous keys are revoked. Refunds are handled manually. x402: request without payment to receive a v2 PAYMENT-REQUIRED challenge; sign one accepted Base or Solana USDC option, retry with PAYMENT-SIGNATURE. PAYMENT-RESPONSE contains the settlement receipt. Failed calls are not settled. Counters reset on service restart. Pass expiry is enforced even when the key verifier is cached. Errors: 400 invalid/unknown parameters; 401 invalid or expired key; 402 payment required or verification failed; 409 payment in flight/replayed; 429 minute_quota_exceeded, daily_quota_exceeded, free_tier_paused (Retry-After); 502 upstream error; 503 busy/unavailable. RateLimit-* and X-RateLimit-* describe key quotas. ## Endpoints - [GET /v1/tokens](https://stonkfun.x4o2.com/v1/tokens): Observed token mints, paginated (0.001 USD via x402) Request body: ```json {} ``` Parameters: ```json [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page size", "minimum": 1, "maximum": 100, "default": 20 }, "description": "Page size", "example": "1" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Offset", "minimum": 0, "maximum": 250000, "default": 0 }, "description": "Offset" }, { "name": "quoteMint", "in": "query", "required": false, "schema": { "type": "string", "description": "Exact quote mint; required for ranking or candles" }, "description": "Exact quote mint; required for ranking or candles" } ] ``` Responses (schemas and captured examples): ```json { "200": { "description": "Verified observations; inspect meta and coverage for freshness and partial history", "content": { "application/json": { "schema": { "type": [ "object", "null" ], "properties": { "data": { "type": [ "object", "null" ], "properties": { "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "mint": { "type": [ "string", "null" ] }, "createdAt": { "type": [ "string", "null" ] }, "firstSeenAt": { "type": [ "string", "null" ] } } } }, "total": { "type": [ "number", "null" ] }, "limit": { "type": [ "number", "null" ] }, "offset": { "type": [ "number", "null" ] }, "partial": { "type": [ "boolean", "null" ] } } }, "meta": { "type": [ "object", "null" ], "properties": { "observedAt": { "type": [ "number", "null" ] }, "ageMs": { "type": [ "number", "null" ] }, "source": { "type": [ "string", "null" ] }, "partial": { "type": [ "boolean", "null" ] }, "commitment": { "type": [ "string", "null" ] }, "freshnessSeconds": { "type": [ "number", "null" ] }, "discoveryAt": { "type": [ "string", "null" ] } } } } }, "example": { "data": { "items": [ { "mint": "HpTqFB77DA8wneveRsSc9gnhjpUnjacLXcvwwsfcna49", "createdAt": "2026-10-31T04:08:45.000Z", "firstSeenAt": "2026-10-31T05:24:02.010Z" } ], "total": 12160, "limit": 1, "offset": 0, "partial": true }, "meta": { "observedAt": 1793424313992, "ageMs": 1093, "source": "cache", "partial": true, "commitment": "finalized", "freshnessSeconds": 120, "discoveryAt": "2026-10-31T05:25:13.992Z" } } } } }, "400": { "description": "Invalid or unknown query" }, "402": { "description": "Pay with x402; the x4o2-free-key extension describes signup and Authorization" }, "404": { "description": "Unknown token or exact market" }, "429": { "description": "Free-key quota or pause: Retry-After, docs Link and upgrade object with price, networks, payment instructions and UTC daily reset. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows (reset in seconds)." }, "503": { "description": "Provider unavailable or exhausted budget; no payment settlement" } } ``` - [GET /v1/tokens/{mint}](https://stonkfun.x4o2.com/v1/tokens/{mint}): Exact token markets and freshness (0.001 USD via x402) Request body: ```json {} ``` Parameters: ```json [ { "name": "mint", "in": "path", "required": true, "schema": { "type": "string", "description": "Exact Solana token mint" }, "description": "Exact Solana token mint", "example": "HkQeu1qNSFYmpidYBQeSzDVx5Lzpz58UEEwbNe4DNET1" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page size", "minimum": 1, "maximum": 100, "default": 20 }, "description": "Page size", "example": "1" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Offset", "minimum": 0, "maximum": 250000, "default": 0 }, "description": "Offset" }, { "name": "quoteMint", "in": "query", "required": false, "schema": { "type": "string", "description": "Exact quote mint; required for ranking or candles" }, "description": "Exact quote mint; required for ranking or candles", "example": "Xsv9hRk1z5ystj9MhnA7Lq4vjSsLwzL2nxrwmwtD3re" }, { "name": "pool", "in": "query", "required": false, "schema": { "type": "string", "description": "Exact pool address; required for candles" }, "description": "Exact pool address; required for candles", "example": "5Frbo3BCQy5t32FRUAGMhU4wEdzQRD3rVjZyNJExK6JQ" }, { "name": "lifecycle", "in": "query", "required": false, "schema": { "type": "string", "description": "Lifecycle", "enum": [ "bonding", "migrating", "graduated" ] }, "description": "Lifecycle" }, { "name": "kind", "in": "query", "required": false, "schema": { "type": "string", "description": "Pool program", "enum": [ "launchlab", "cpmm", "amm-v4" ] }, "description": "Pool program" } ] ``` Responses (schemas and captured examples): ```json { "200": { "description": "Verified observations; inspect meta and coverage for freshness and partial history", "content": { "application/json": { "schema": { "type": [ "object", "null" ], "properties": { "data": { "type": [ "object", "null" ], "properties": { "mint": { "type": [ "string", "null" ] }, "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "pool": { "type": [ "string", "null" ] }, "curvePool": { "type": [ "string", "null" ] }, "mint": { "type": [ "string", "null" ] }, "quoteMint": { "type": [ "string", "null" ] }, "platformConfig": { "type": [ "string", "null" ] }, "kind": { "type": [ "string", "null" ] }, "lifecycle": { "type": [ "string", "null" ] }, "creator": { "type": [ "string", "null" ] }, "decimals": { "type": [ "number", "null" ] }, "quoteDecimals": { "type": [ "number", "null" ] }, "name": {}, "symbol": {}, "createdAt": {}, "firstSeenAt": { "type": [ "string", "null" ] }, "observedAt": { "type": [ "string", "null" ] }, "slot": { "type": [ "number", "null" ] }, "priceQuote": { "type": [ "number", "null" ] }, "supply": {}, "marketCapQuote": {}, "realQuote": {}, "protocolFeeQuote": {}, "platformFeeQuote": {}, "migrationSignature": {}, "globalConfig": { "type": [ "string", "null" ] }, "curveType": { "type": [ "number", "null" ] }, "priceUsd": {}, "marketCapUsd": {}, "quoteUsd": {}, "quoteUsdObservedAt": {}, "supplyObservedAt": {}, "stale": { "type": [ "boolean", "null" ] }, "partial": { "type": [ "boolean", "null" ] } } } }, "total": { "type": [ "number", "null" ] }, "limit": { "type": [ "number", "null" ] }, "offset": { "type": [ "number", "null" ] }, "partial": { "type": [ "boolean", "null" ] } } }, "meta": { "type": [ "object", "null" ], "properties": { "observedAt": { "type": [ "number", "null" ] }, "ageMs": { "type": [ "number", "null" ] }, "source": { "type": [ "string", "null" ] }, "partial": { "type": [ "boolean", "null" ] }, "commitment": { "type": [ "string", "null" ] }, "freshnessSeconds": { "type": [ "number", "null" ] }, "discoveryAt": { "type": [ "string", "null" ] } } } } }, "example": { "data": { "mint": "HkQeu1qNSFYmpidYBQeSzDVx5Lzpz58UEEwbNe4DNET1", "items": [ { "pool": "5Frbo3BCQy5t32FRUAGMhU4wEdzQRD3rVjZyNJExK6JQ", "curvePool": "9xzX6redHyy99zkZhvRpbncUcUEQRbjV1P1g3VGJUjhw", "mint": "HkQeu1qNSFYmpidYBQeSzDVx5Lzpz58UEEwbNe4DNET1", "quoteMint": "Xsv9hRk1z5ystj9MhnA7Lq4vjSsLwzL2nxrwmwtD3re", "platformConfig": "6BwHHDg3u1854jC8PDLXvR4spTcLNaoBxLJNGC4nTESt", "kind": "cpmm", "lifecycle": "graduated", "creator": "EpgKoofCzeHXQxAohXitF99aDTgzi9JpF1uFLGTXWuJA", "decimals": 6, "quoteDecimals": 8, "name": null, "symbol": null, "createdAt": null, "firstSeenAt": "2026-10-31T05:24:45.641Z", "observedAt": "2026-10-31T05:25:00.907Z", "slot": 463569826, "priceQuote": 1.2610362006774265e-7, "supply": null, "marketCapQuote": null, "realQuote": null, "protocolFeeQuote": null, "platformFeeQuote": null, "migrationSignature": null, "globalConfig": "Crvp3VHo4eqyARzFsnwygu3Y9aWgfy9zupQtcVVuZN2K", "curveType": 0, "priceUsd": null, "marketCapUsd": null, "quoteUsd": null, "quoteUsdObservedAt": null, "supplyObservedAt": null, "stale": false, "partial": true } ], "total": 1, "limit": 1, "offset": 0, "partial": true }, "meta": { "observedAt": 1793424300907, "ageMs": 15836, "source": "cache", "partial": true, "commitment": "finalized", "freshnessSeconds": 120, "discoveryAt": "2026-10-31T05:25:13.992Z" } } } } }, "400": { "description": "Invalid or unknown query" }, "402": { "description": "Pay with x402; the x4o2-free-key extension describes signup and Authorization" }, "404": { "description": "Unknown token or exact market" }, "429": { "description": "Free-key quota or pause: Retry-After, docs Link and upgrade object with price, networks, payment instructions and UTC daily reset. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows (reset in seconds)." }, "503": { "description": "Provider unavailable or exhausted budget; no payment settlement" } } ``` - [GET /v1/pairings](https://stonkfun.x4o2.com/v1/pairings): Quote mints verified in Stonk platform pools (0.001 USD via x402) Request body: ```json {} ``` Parameters: ```json [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page size", "minimum": 1, "maximum": 100, "default": 20 }, "description": "Page size", "example": "1" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Offset", "minimum": 0, "maximum": 250000, "default": 0 }, "description": "Offset" } ] ``` Responses (schemas and captured examples): ```json { "200": { "description": "Verified observations; inspect meta and coverage for freshness and partial history", "content": { "application/json": { "schema": { "type": [ "object", "null" ], "properties": { "data": { "type": [ "object", "null" ], "properties": { "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "mint": { "type": [ "string", "null" ] }, "tokenCount": { "type": [ "number", "null" ] }, "poolCount": { "type": [ "number", "null" ] }, "observedAt": { "type": [ "string", "null" ] } } } }, "total": { "type": [ "number", "null" ] }, "limit": { "type": [ "number", "null" ] }, "offset": { "type": [ "number", "null" ] }, "partial": { "type": [ "boolean", "null" ] }, "membership": { "type": [ "string", "null" ] } } }, "meta": { "type": [ "object", "null" ], "properties": { "observedAt": { "type": [ "number", "null" ] }, "ageMs": { "type": [ "number", "null" ] }, "source": { "type": [ "string", "null" ] }, "partial": { "type": [ "boolean", "null" ] }, "commitment": { "type": [ "string", "null" ] }, "freshnessSeconds": { "type": [ "number", "null" ] }, "discoveryAt": { "type": [ "string", "null" ] } } } } }, "example": { "data": { "items": [ { "mint": "A7bdiYdS5GjqGFtxf17ppRHtDKPkkRqbKtR27dxvQXaS", "tokenCount": 871, "poolCount": 871, "observedAt": "2026-10-31T05:25:14.072Z" } ], "total": 397, "limit": 1, "offset": 0, "partial": true, "membership": "Verified Stonk platform pool quote; website pairing availability is unknown." }, "meta": { "observedAt": 1793424314072, "ageMs": 2856, "source": "cache", "partial": true, "commitment": "finalized", "freshnessSeconds": 120, "discoveryAt": "2026-10-31T05:25:13.992Z" } } } } }, "400": { "description": "Invalid or unknown query" }, "402": { "description": "Pay with x402; the x4o2-free-key extension describes signup and Authorization" }, "404": { "description": "Unknown token or exact market" }, "429": { "description": "Free-key quota or pause: Retry-After, docs Link and upgrade object with price, networks, payment instructions and UTC daily reset. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows (reset in seconds)." }, "503": { "description": "Provider unavailable or exhausted budget; no payment settlement" } } ``` - [GET /v1/quotes](https://stonkfun.x4o2.com/v1/quotes): Alias of verified pairing quotes (0.001 USD via x402) Request body: ```json {} ``` Parameters: ```json [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page size", "minimum": 1, "maximum": 100, "default": 20 }, "description": "Page size", "example": "1" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Offset", "minimum": 0, "maximum": 250000, "default": 0 }, "description": "Offset" } ] ``` Responses (schemas and captured examples): ```json { "200": { "description": "Verified observations; inspect meta and coverage for freshness and partial history", "content": { "application/json": { "schema": { "type": [ "object", "null" ], "properties": { "data": { "type": [ "object", "null" ], "properties": { "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "mint": { "type": [ "string", "null" ] }, "tokenCount": { "type": [ "number", "null" ] }, "poolCount": { "type": [ "number", "null" ] }, "observedAt": { "type": [ "string", "null" ] } } } }, "total": { "type": [ "number", "null" ] }, "limit": { "type": [ "number", "null" ] }, "offset": { "type": [ "number", "null" ] }, "partial": { "type": [ "boolean", "null" ] }, "membership": { "type": [ "string", "null" ] } } }, "meta": { "type": [ "object", "null" ], "properties": { "observedAt": { "type": [ "number", "null" ] }, "ageMs": { "type": [ "number", "null" ] }, "source": { "type": [ "string", "null" ] }, "partial": { "type": [ "boolean", "null" ] }, "commitment": { "type": [ "string", "null" ] }, "freshnessSeconds": { "type": [ "number", "null" ] }, "discoveryAt": { "type": [ "string", "null" ] } } } } }, "example": { "data": { "items": [ { "mint": "A7bdiYdS5GjqGFtxf17ppRHtDKPkkRqbKtR27dxvQXaS", "tokenCount": 871, "poolCount": 871, "observedAt": "2026-10-31T05:25:14.072Z" } ], "total": 397, "limit": 1, "offset": 0, "partial": true, "membership": "Verified Stonk platform pool quote; website pairing availability is unknown." }, "meta": { "observedAt": 1793424314072, "ageMs": 4093, "source": "cache", "partial": true, "commitment": "finalized", "freshnessSeconds": 120, "discoveryAt": "2026-10-31T05:25:18.025Z" } } } } }, "400": { "description": "Invalid or unknown query" }, "402": { "description": "Pay with x402; the x4o2-free-key extension describes signup and Authorization" }, "404": { "description": "Unknown token or exact market" }, "429": { "description": "Free-key quota or pause: Retry-After, docs Link and upgrade object with price, networks, payment instructions and UTC daily reset. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows (reset in seconds)." }, "503": { "description": "Provider unavailable or exhausted budget; no payment settlement" } } ``` - [GET /v1/launches](https://stonkfun.x4o2.com/v1/launches): Recent verified LaunchLab pools; unknown creation times remain null (0.001 USD via x402) Request body: ```json {} ``` Parameters: ```json [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page size", "minimum": 1, "maximum": 100, "default": 20 }, "description": "Page size", "example": "1" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Offset", "minimum": 0, "maximum": 250000, "default": 0 }, "description": "Offset" }, { "name": "quoteMint", "in": "query", "required": false, "schema": { "type": "string", "description": "Exact quote mint; required for ranking or candles" }, "description": "Exact quote mint; required for ranking or candles" }, { "name": "pool", "in": "query", "required": false, "schema": { "type": "string", "description": "Exact pool address; required for candles" }, "description": "Exact pool address; required for candles" }, { "name": "lifecycle", "in": "query", "required": false, "schema": { "type": "string", "description": "Lifecycle", "enum": [ "bonding", "migrating", "graduated" ] }, "description": "Lifecycle" }, { "name": "kind", "in": "query", "required": false, "schema": { "type": "string", "description": "Pool program", "enum": [ "launchlab", "cpmm", "amm-v4" ] }, "description": "Pool program" } ] ``` Responses (schemas and captured examples): ```json { "200": { "description": "Verified observations; inspect meta and coverage for freshness and partial history", "content": { "application/json": { "schema": { "type": [ "object", "null" ], "properties": { "data": { "type": [ "object", "null" ], "properties": { "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "pool": { "type": [ "string", "null" ] }, "curvePool": { "type": [ "string", "null" ] }, "mint": { "type": [ "string", "null" ] }, "quoteMint": { "type": [ "string", "null" ] }, "platformConfig": { "type": [ "string", "null" ] }, "kind": { "type": [ "string", "null" ] }, "lifecycle": { "type": [ "string", "null" ] }, "creator": { "type": [ "string", "null" ] }, "decimals": { "type": [ "number", "null" ] }, "quoteDecimals": { "type": [ "number", "null" ] }, "name": { "type": [ "string", "null" ] }, "symbol": { "type": [ "string", "null" ] }, "createdAt": { "type": [ "string", "null" ] }, "firstSeenAt": { "type": [ "string", "null" ] }, "observedAt": { "type": [ "string", "null" ] }, "slot": { "type": [ "number", "null" ] }, "priceQuote": { "type": [ "number", "null" ] }, "supply": {}, "marketCapQuote": {}, "realQuote": { "type": [ "number", "null" ] }, "protocolFeeQuote": { "type": [ "number", "null" ] }, "platformFeeQuote": { "type": [ "number", "null" ] }, "migrationSignature": {}, "globalConfig": { "type": [ "string", "null" ] }, "curveType": { "type": [ "number", "null" ] }, "priceUsd": {}, "marketCapUsd": {}, "quoteUsd": {}, "quoteUsdObservedAt": {}, "supplyObservedAt": {}, "stale": { "type": [ "boolean", "null" ] }, "partial": { "type": [ "boolean", "null" ] } } } }, "total": { "type": [ "number", "null" ] }, "limit": { "type": [ "number", "null" ] }, "offset": { "type": [ "number", "null" ] }, "partial": { "type": [ "boolean", "null" ] } } }, "meta": { "type": [ "object", "null" ], "properties": { "observedAt": { "type": [ "number", "null" ] }, "ageMs": { "type": [ "number", "null" ] }, "source": { "type": [ "string", "null" ] }, "partial": { "type": [ "boolean", "null" ] }, "commitment": { "type": [ "string", "null" ] }, "freshnessSeconds": { "type": [ "number", "null" ] }, "discoveryAt": { "type": [ "string", "null" ] } } } } }, "example": { "data": { "items": [ { "pool": "BBzMt9cR4GgjLEzY3PW35PYdnbZLXfGPNsK5MfJy2pHJ", "curvePool": "BBzMt9cR4GgjLEzY3PW35PYdnbZLXfGPNsK5MfJy2pHJ", "mint": "HpTqFB77DA8wneveRsSc9gnhjpUnjacLXcvwwsfcna49", "quoteMint": "So11111111111111111111111111111111111111112", "platformConfig": "4E876qZTE9FJMrBzgVtBrSrzz2TLivB5Y5QXPjB4gZL7", "kind": "launchlab", "lifecycle": "bonding", "creator": "9jfUjyeZDWBJnkmBUjr3AbJ5uFQWHYwt74d1fz6tsitq", "decimals": 6, "quoteDecimals": 9, "name": "JELNO", "symbol": "JELNO", "createdAt": "2026-10-31T04:08:45.000Z", "firstSeenAt": "2026-10-31T05:24:02.010Z", "observedAt": "2026-10-31T05:24:02.010Z", "slot": 463569543, "priceQuote": 2.795912119480661e-8, "supply": null, "marketCapQuote": null, "realQuote": 1e-9, "protocolFeeQuote": 0.011911753, "platformFeeQuote": 0, "migrationSignature": null, "globalConfig": "6s1xP3hpbAfFoNtUNF8mfHsjr2Bd97JxFJRWLbL6aHuX", "curveType": 0, "priceUsd": null, "marketCapUsd": null, "quoteUsd": null, "quoteUsdObservedAt": null, "supplyObservedAt": null, "stale": false, "partial": true } ], "total": 12212, "limit": 1, "offset": 0, "partial": true }, "meta": { "observedAt": 1793424242010, "ageMs": 76214, "source": "cache", "partial": true, "commitment": "finalized", "freshnessSeconds": 120, "discoveryAt": "2026-10-31T05:25:18.025Z" } } } } }, "400": { "description": "Invalid or unknown query" }, "402": { "description": "Pay with x402; the x4o2-free-key extension describes signup and Authorization" }, "404": { "description": "Unknown token or exact market" }, "429": { "description": "Free-key quota or pause: Retry-After, docs Link and upgrade object with price, networks, payment instructions and UTC daily reset. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows (reset in seconds)." }, "503": { "description": "Provider unavailable or exhausted budget; no payment settlement" } } ``` - [GET /v1/markets](https://stonkfun.x4o2.com/v1/markets): Pools by exact token/quote and lifecycle (0.001 USD via x402) Request body: ```json {} ``` Parameters: ```json [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page size", "minimum": 1, "maximum": 100, "default": 20 }, "description": "Page size", "example": "1" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Offset", "minimum": 0, "maximum": 250000, "default": 0 }, "description": "Offset" }, { "name": "quoteMint", "in": "query", "required": false, "schema": { "type": "string", "description": "Exact quote mint; required for ranking or candles" }, "description": "Exact quote mint; required for ranking or candles", "example": "Xsv9hRk1z5ystj9MhnA7Lq4vjSsLwzL2nxrwmwtD3re" }, { "name": "pool", "in": "query", "required": false, "schema": { "type": "string", "description": "Exact pool address; required for candles" }, "description": "Exact pool address; required for candles" }, { "name": "lifecycle", "in": "query", "required": false, "schema": { "type": "string", "description": "Lifecycle", "enum": [ "bonding", "migrating", "graduated" ] }, "description": "Lifecycle" }, { "name": "kind", "in": "query", "required": false, "schema": { "type": "string", "description": "Pool program", "enum": [ "launchlab", "cpmm", "amm-v4" ] }, "description": "Pool program" }, { "name": "mint", "in": "query", "required": false, "schema": { "type": "string", "description": "Exact Solana token mint" }, "description": "Exact Solana token mint", "example": "HkQeu1qNSFYmpidYBQeSzDVx5Lzpz58UEEwbNe4DNET1" } ] ``` Responses (schemas and captured examples): ```json { "200": { "description": "Verified observations; inspect meta and coverage for freshness and partial history", "content": { "application/json": { "schema": { "type": [ "object", "null" ], "properties": { "data": { "type": [ "object", "null" ], "properties": { "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "pool": { "type": [ "string", "null" ] }, "curvePool": { "type": [ "string", "null" ] }, "mint": { "type": [ "string", "null" ] }, "quoteMint": { "type": [ "string", "null" ] }, "platformConfig": { "type": [ "string", "null" ] }, "kind": { "type": [ "string", "null" ] }, "lifecycle": { "type": [ "string", "null" ] }, "creator": { "type": [ "string", "null" ] }, "decimals": { "type": [ "number", "null" ] }, "quoteDecimals": { "type": [ "number", "null" ] }, "name": {}, "symbol": {}, "createdAt": {}, "firstSeenAt": { "type": [ "string", "null" ] }, "observedAt": { "type": [ "string", "null" ] }, "slot": { "type": [ "number", "null" ] }, "priceQuote": { "type": [ "number", "null" ] }, "supply": {}, "marketCapQuote": {}, "realQuote": {}, "protocolFeeQuote": {}, "platformFeeQuote": {}, "migrationSignature": {}, "globalConfig": { "type": [ "string", "null" ] }, "curveType": { "type": [ "number", "null" ] }, "priceUsd": {}, "marketCapUsd": {}, "quoteUsd": {}, "quoteUsdObservedAt": {}, "supplyObservedAt": {}, "stale": { "type": [ "boolean", "null" ] }, "partial": { "type": [ "boolean", "null" ] } } } }, "total": { "type": [ "number", "null" ] }, "limit": { "type": [ "number", "null" ] }, "offset": { "type": [ "number", "null" ] }, "partial": { "type": [ "boolean", "null" ] } } }, "meta": { "type": [ "object", "null" ], "properties": { "observedAt": { "type": [ "number", "null" ] }, "ageMs": { "type": [ "number", "null" ] }, "source": { "type": [ "string", "null" ] }, "partial": { "type": [ "boolean", "null" ] }, "commitment": { "type": [ "string", "null" ] }, "freshnessSeconds": { "type": [ "number", "null" ] }, "discoveryAt": { "type": [ "string", "null" ] } } } } }, "example": { "data": { "items": [ { "pool": "5Frbo3BCQy5t32FRUAGMhU4wEdzQRD3rVjZyNJExK6JQ", "curvePool": "9xzX6redHyy99zkZhvRpbncUcUEQRbjV1P1g3VGJUjhw", "mint": "HkQeu1qNSFYmpidYBQeSzDVx5Lzpz58UEEwbNe4DNET1", "quoteMint": "Xsv9hRk1z5ystj9MhnA7Lq4vjSsLwzL2nxrwmwtD3re", "platformConfig": "6BwHHDg3u1854jC8PDLXvR4spTcLNaoBxLJNGC4nTESt", "kind": "cpmm", "lifecycle": "graduated", "creator": "EpgKoofCzeHXQxAohXitF99aDTgzi9JpF1uFLGTXWuJA", "decimals": 6, "quoteDecimals": 8, "name": null, "symbol": null, "createdAt": null, "firstSeenAt": "2026-10-31T05:24:45.641Z", "observedAt": "2026-10-31T05:25:00.907Z", "slot": 463569826, "priceQuote": 1.2610362006774265e-7, "supply": null, "marketCapQuote": null, "realQuote": null, "protocolFeeQuote": null, "platformFeeQuote": null, "migrationSignature": null, "globalConfig": "Crvp3VHo4eqyARzFsnwygu3Y9aWgfy9zupQtcVVuZN2K", "curveType": 0, "priceUsd": null, "marketCapUsd": null, "quoteUsd": null, "quoteUsdObservedAt": null, "supplyObservedAt": null, "stale": false, "partial": true } ], "total": 2, "limit": 1, "offset": 0, "partial": true }, "meta": { "observedAt": 1793424300907, "ageMs": 17357, "source": "cache", "partial": true, "commitment": "finalized", "freshnessSeconds": 120, "discoveryAt": "2026-10-31T05:25:18.025Z" } } } } }, "400": { "description": "Invalid or unknown query" }, "402": { "description": "Pay with x402; the x4o2-free-key extension describes signup and Authorization" }, "404": { "description": "Unknown token or exact market" }, "429": { "description": "Free-key quota or pause: Retry-After, docs Link and upgrade object with price, networks, payment instructions and UTC daily reset. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows (reset in seconds)." }, "503": { "description": "Provider unavailable or exhausted budget; no payment settlement" } } ``` - [GET /v1/tokens/{mint}/candles](https://stonkfun.x4o2.com/v1/tokens/{mint}/candles): Exact-market OHLCV in quote units; 1m through 1d (0.001 USD via x402) Request body: ```json {} ``` Parameters: ```json [ { "name": "mint", "in": "path", "required": true, "schema": { "type": "string", "description": "Exact Solana token mint" }, "description": "Exact Solana token mint", "example": "HkQeu1qNSFYmpidYBQeSzDVx5Lzpz58UEEwbNe4DNET1" }, { "name": "pool", "in": "query", "required": true, "schema": { "type": "string", "description": "Exact pool address; required for candles" }, "description": "Exact pool address; required for candles", "example": "5Frbo3BCQy5t32FRUAGMhU4wEdzQRD3rVjZyNJExK6JQ" }, { "name": "quoteMint", "in": "query", "required": true, "schema": { "type": "string", "description": "Exact quote mint; required for ranking or candles" }, "description": "Exact quote mint; required for ranking or candles", "example": "Xsv9hRk1z5ystj9MhnA7Lq4vjSsLwzL2nxrwmwtD3re" }, { "name": "res", "in": "query", "required": false, "schema": { "type": "string", "description": "Candle resolution", "enum": [ "1m", "5m", "15m", "1h", "4h", "1d" ], "default": "5m" }, "description": "Candle resolution", "example": "1h" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Candle count", "minimum": 1, "maximum": 1000, "default": 300 }, "description": "Candle count", "example": "3" }, { "name": "before", "in": "query", "required": false, "schema": { "type": "integer", "description": "Exclusive candle bucket upper bound, Unix seconds", "minimum": 1 }, "description": "Exclusive candle bucket upper bound, Unix seconds" } ] ``` Responses (schemas and captured examples): ```json { "200": { "description": "Verified observations; inspect meta and coverage for freshness and partial history", "content": { "application/json": { "schema": { "type": [ "object", "null" ], "properties": { "data": { "type": [ "object", "null" ], "properties": { "mint": { "type": [ "string", "null" ] }, "quoteMint": { "type": [ "string", "null" ] }, "pool": { "type": [ "string", "null" ] }, "res": { "type": [ "string", "null" ] }, "measure": { "type": [ "string", "null" ] }, "currency": { "type": [ "string", "null" ] }, "quoteUsd": {}, "quoteUsdObservedAt": {}, "source": { "type": [ "string", "null" ] }, "fetchedAt": { "type": [ "string", "null" ] }, "candles": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "time": { "type": [ "number", "null" ] }, "open": { "type": [ "number", "null" ] }, "high": { "type": [ "number", "null" ] }, "low": { "type": [ "number", "null" ] }, "close": { "type": [ "number", "null" ] }, "volumeQuote": { "type": [ "number", "null" ] }, "volumeUsd": {}, "trades": {} } } }, "coverage": { "type": [ "object", "null" ], "properties": { "partial": { "type": [ "boolean", "null" ] }, "historyComplete": { "type": [ "boolean", "null" ] }, "ordering": { "type": [ "string", "null" ] }, "retentionDays": { "type": [ "number", "null" ] }, "from": { "type": [ "number", "null" ] }, "to": { "type": [ "number", "null" ] } } }, "busy": { "type": [ "boolean", "null" ] }, "serverTime": { "type": [ "string", "null" ] } } }, "meta": { "type": [ "object", "null" ], "properties": { "observedAt": { "type": [ "number", "null" ] }, "ageMs": { "type": [ "number", "null" ] }, "source": { "type": [ "string", "null" ] }, "partial": { "type": [ "boolean", "null" ] }, "commitment": { "type": [ "string", "null" ] }, "freshnessSeconds": { "type": [ "number", "null" ] }, "discoveryAt": { "type": [ "string", "null" ] } } } } }, "example": { "data": { "mint": "HkQeu1qNSFYmpidYBQeSzDVx5Lzpz58UEEwbNe4DNET1", "quoteMint": "Xsv9hRk1z5ystj9MhnA7Lq4vjSsLwzL2nxrwmwtD3re", "pool": "5Frbo3BCQy5t32FRUAGMhU4wEdzQRD3rVjZyNJExK6JQ", "res": "1h", "measure": "price", "currency": "quote", "quoteUsd": null, "quoteUsdObservedAt": null, "source": "GeckoTerminal", "fetchedAt": "2026-10-31T05:25:14.872Z", "candles": [ { "time": 1793412000, "open": 1.35876455898026e-7, "high": 1.35876455898026e-7, "low": 1.27778351583101e-7, "close": 1.35876455898026e-7, "volumeQuote": 0.17467692, "volumeUsd": null, "trades": null }, { "time": 1793422800, "open": 1.35876455898026e-7, "high": 1.35876455898026e-7, "low": 1.24990294378267e-7, "close": 1.24990294378267e-7, "volumeQuote": 0.89354456, "volumeUsd": null, "trades": null } ], "coverage": { "partial": true, "historyComplete": false, "ordering": "block-time, slot; same-slot transaction order unavailable", "retentionDays": 90, "from": 1793412000, "to": 1793422800 }, "busy": false, "serverTime": "2026-10-31T05:25:18.437Z" }, "meta": { "observedAt": 1793424314872, "ageMs": 3565, "source": "cache", "partial": true, "commitment": "finalized", "freshnessSeconds": 120, "discoveryAt": "2026-10-31T05:25:18.367Z" } } } } }, "400": { "description": "Invalid or unknown query" }, "402": { "description": "Pay with x402; the x4o2-free-key extension describes signup and Authorization" }, "404": { "description": "Unknown token or exact market" }, "429": { "description": "Free-key quota or pause: Retry-After, docs Link and upgrade object with price, networks, payment instructions and UTC daily reset. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows (reset in seconds)." }, "503": { "description": "Provider unavailable or exhausted budget; no payment settlement" } } ``` - [GET /v1/trending](https://stonkfun.x4o2.com/v1/trending): 24h observed swap volume or fresh market cap within one quote mint (0.001 USD via x402) Request body: ```json {} ``` Parameters: ```json [ { "name": "quoteMint", "in": "query", "required": true, "schema": { "type": "string", "description": "Exact quote mint; required for ranking or candles" }, "description": "Exact quote mint; required for ranking or candles", "example": "Xsv9hRk1z5ystj9MhnA7Lq4vjSsLwzL2nxrwmwtD3re" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page size", "minimum": 1, "maximum": 100, "default": 20 }, "description": "Page size", "example": "1" }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "description": "Ranking metric", "enum": [ "volume", "mcap" ], "default": "volume" }, "description": "Ranking metric" } ] ``` Responses (schemas and captured examples): ```json { "200": { "description": "Verified observations; inspect meta and coverage for freshness and partial history", "content": { "application/json": { "schema": { "type": [ "object", "null" ], "properties": { "data": { "type": [ "object", "null" ], "properties": { "items": { "type": [ "array", "null" ] }, "quoteMint": { "type": [ "string", "null" ] }, "sort": { "type": [ "string", "null" ] }, "windowSeconds": { "type": [ "number", "null" ] }, "limit": { "type": [ "number", "null" ] }, "partial": { "type": [ "boolean", "null" ] } } }, "meta": { "type": [ "object", "null" ], "properties": { "observedAt": { "type": [ "number", "null" ] }, "ageMs": { "type": [ "number", "null" ] }, "source": { "type": [ "string", "null" ] }, "partial": { "type": [ "boolean", "null" ] }, "commitment": { "type": [ "string", "null" ] }, "freshnessSeconds": { "type": [ "number", "null" ] }, "discoveryAt": { "type": [ "string", "null" ] } } } } }, "example": { "data": { "items": [], "quoteMint": "Xsv9hRk1z5ystj9MhnA7Lq4vjSsLwzL2nxrwmwtD3re", "sort": "volume", "windowSeconds": 86400, "limit": 1, "partial": true }, "meta": { "observedAt": 1793424318367, "ageMs": 107, "source": "cache", "partial": true, "commitment": "finalized", "freshnessSeconds": 120, "discoveryAt": "2026-10-31T05:25:18.367Z" } } } } }, "400": { "description": "Invalid or unknown query" }, "402": { "description": "Pay with x402; the x4o2-free-key extension describes signup and Authorization" }, "404": { "description": "Unknown token or exact market" }, "429": { "description": "Free-key quota or pause: Retry-After, docs Link and upgrade object with price, networks, payment instructions and UTC daily reset. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows (reset in seconds)." }, "503": { "description": "Provider unavailable or exhausted budget; no payment settlement" } } ``` - [GET /v1/leaderboard](https://stonkfun.x4o2.com/v1/leaderboard): Alias of quote-specific trending (0.001 USD via x402) Request body: ```json {} ``` Parameters: ```json [ { "name": "quoteMint", "in": "query", "required": true, "schema": { "type": "string", "description": "Exact quote mint; required for ranking or candles" }, "description": "Exact quote mint; required for ranking or candles", "example": "Xsv9hRk1z5ystj9MhnA7Lq4vjSsLwzL2nxrwmwtD3re" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page size", "minimum": 1, "maximum": 100, "default": 20 }, "description": "Page size", "example": "1" }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "description": "Ranking metric", "enum": [ "volume", "mcap" ], "default": "volume" }, "description": "Ranking metric" } ] ``` Responses (schemas and captured examples): ```json { "200": { "description": "Verified observations; inspect meta and coverage for freshness and partial history", "content": { "application/json": { "schema": { "type": [ "object", "null" ], "properties": { "data": { "type": [ "object", "null" ], "properties": { "items": { "type": [ "array", "null" ] }, "quoteMint": { "type": [ "string", "null" ] }, "sort": { "type": [ "string", "null" ] }, "windowSeconds": { "type": [ "number", "null" ] }, "limit": { "type": [ "number", "null" ] }, "partial": { "type": [ "boolean", "null" ] } } }, "meta": { "type": [ "object", "null" ], "properties": { "observedAt": { "type": [ "number", "null" ] }, "ageMs": { "type": [ "number", "null" ] }, "source": { "type": [ "string", "null" ] }, "partial": { "type": [ "boolean", "null" ] }, "commitment": { "type": [ "string", "null" ] }, "freshnessSeconds": { "type": [ "number", "null" ] }, "discoveryAt": { "type": [ "string", "null" ] } } } } }, "example": { "data": { "items": [], "quoteMint": "Xsv9hRk1z5ystj9MhnA7Lq4vjSsLwzL2nxrwmwtD3re", "sort": "volume", "windowSeconds": 86400, "limit": 1, "partial": true }, "meta": { "observedAt": 1793424318367, "ageMs": 151, "source": "cache", "partial": true, "commitment": "finalized", "freshnessSeconds": 120, "discoveryAt": "2026-10-31T05:25:18.367Z" } } } } }, "400": { "description": "Invalid or unknown query" }, "402": { "description": "Pay with x402; the x4o2-free-key extension describes signup and Authorization" }, "404": { "description": "Unknown token or exact market" }, "429": { "description": "Free-key quota or pause: Retry-After, docs Link and upgrade object with price, networks, payment instructions and UTC daily reset. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows (reset in seconds)." }, "503": { "description": "Provider unavailable or exhausted budget; no payment settlement" } } ``` - [GET /v1/tokens/{mint}/holders](https://stonkfun.x4o2.com/v1/tokens/{mint}/holders): Owners of up to 20 largest token accounts; total wallet count unknown (0.001 USD via x402) Request body: ```json {} ``` Parameters: ```json [ { "name": "mint", "in": "path", "required": true, "schema": { "type": "string", "description": "Exact Solana token mint" }, "description": "Exact Solana token mint", "example": "HkQeu1qNSFYmpidYBQeSzDVx5Lzpz58UEEwbNe4DNET1" } ] ``` Responses (schemas and captured examples): ```json { "200": { "description": "Verified observations; inspect meta and coverage for freshness and partial history", "content": { "application/json": { "schema": { "type": [ "object", "null" ], "properties": { "data": { "type": [ "object", "null" ], "properties": { "mint": { "type": [ "string", "null" ] }, "holderCount": {}, "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "owner": { "type": [ "string", "null" ] }, "amount": { "type": [ "number", "null" ] }, "tokenAccounts": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } } } } }, "observedAt": { "type": [ "string", "null" ] }, "slot": { "type": [ "number", "null" ] }, "coverage": { "type": [ "object", "null" ], "properties": { "partial": { "type": [ "boolean", "null" ] }, "largestTokenAccounts": { "type": [ "number", "null" ] }, "totalWalletHolders": {}, "description": { "type": [ "string", "null" ] } } } } }, "meta": { "type": [ "object", "null" ], "properties": { "observedAt": { "type": [ "number", "null" ] }, "ageMs": { "type": [ "number", "null" ] }, "source": { "type": [ "string", "null" ] }, "partial": { "type": [ "boolean", "null" ] }, "commitment": { "type": [ "string", "null" ] }, "freshnessSeconds": { "type": [ "number", "null" ] }, "discoveryAt": { "type": [ "string", "null" ] } } } } }, "example": { "data": { "mint": "HkQeu1qNSFYmpidYBQeSzDVx5Lzpz58UEEwbNe4DNET1", "holderCount": null, "items": [ { "owner": "GpMZbSM2GgvTKHJirzeGfMFoaZ8UR2X7F4v8vHTvxFbL", "amount": 206530241.533375, "tokenAccounts": [ "3MZho2JQTjD77uUeMXp2Lath8vjqTS1hPg7294bikUJ4" ] }, { "owner": "6r5ww4RiBUDYAwUJs6h63qrmtvZd8YQyWy5t4kzNfjPZ", "amount": 64692862.734942, "tokenAccounts": [ "Br2GTrFpDfyGhHNvVWvRLGyK2d44cFECQ2yZgKA2i3DP" ] }, { "owner": "9fkNwbXHaKBb8F4ivF2hDegXoyXfY1dymY3QRnYHx5aa", "amount": 51751333.432629, "tokenAccounts": [ "GnWeigQUs4e5h1MCVmmpDF4CPRSEA3mmUFBdD3xENVa5" ] } ], "observedAt": "2026-10-31T05:25:18.797Z", "slot": 463569911, "coverage": { "partial": true, "largestTokenAccounts": 20, "totalWalletHolders": null, "description": "Owners aggregated from at most 20 largest token accounts; wallets with other accounts are undercounted; vaults included." } }, "meta": { "observedAt": 1793424318797, "ageMs": 3, "source": "cache", "partial": true, "commitment": "finalized", "freshnessSeconds": 120, "discoveryAt": "2026-10-31T05:25:18.367Z" } } } } }, "400": { "description": "Invalid or unknown query" }, "402": { "description": "Pay with x402; the x4o2-free-key extension describes signup and Authorization" }, "404": { "description": "Unknown token or exact market" }, "429": { "description": "Free-key quota or pause: Retry-After, docs Link and upgrade object with price, networks, payment instructions and UTC daily reset. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows (reset in seconds)." }, "503": { "description": "Provider unavailable or exhausted budget; no payment settlement" } } ``` - [GET /v1/tokens/{mint}/burns](https://stonkfun.x4o2.com/v1/tokens/{mint}/burns): Observed SPL token burns; incomplete history (0.001 USD via x402) Request body: ```json {} ``` Parameters: ```json [ { "name": "mint", "in": "path", "required": true, "schema": { "type": "string", "description": "Exact Solana token mint" }, "description": "Exact Solana token mint", "example": "HkQeu1qNSFYmpidYBQeSzDVx5Lzpz58UEEwbNe4DNET1" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page size", "minimum": 1, "maximum": 100, "default": 20 }, "description": "Page size", "example": "1" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Offset", "minimum": 0, "maximum": 250000, "default": 0 }, "description": "Offset" } ] ``` Responses (schemas and captured examples): ```json { "200": { "description": "Verified observations; inspect meta and coverage for freshness and partial history", "content": { "application/json": { "schema": { "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" ] }, "totalBurned": {}, "partial": { "type": [ "boolean", "null" ] } } }, "meta": { "type": [ "object", "null" ], "properties": { "observedAt": {}, "ageMs": {}, "source": { "type": [ "string", "null" ] }, "partial": { "type": [ "boolean", "null" ] }, "commitment": { "type": [ "string", "null" ] }, "freshnessSeconds": { "type": [ "number", "null" ] }, "discoveryAt": { "type": [ "string", "null" ] } } } } }, "example": { "data": { "mint": "HkQeu1qNSFYmpidYBQeSzDVx5Lzpz58UEEwbNe4DNET1", "items": [], "limit": 1, "offset": 0, "totalBurned": null, "partial": true }, "meta": { "observedAt": null, "ageMs": null, "source": "cache", "partial": true, "commitment": "finalized", "freshnessSeconds": 120, "discoveryAt": "2026-10-31T05:25:18.367Z" } } } } }, "400": { "description": "Invalid or unknown query" }, "402": { "description": "Pay with x402; the x4o2-free-key extension describes signup and Authorization" }, "404": { "description": "Unknown token or exact market" }, "429": { "description": "Free-key quota or pause: Retry-After, docs Link and upgrade object with price, networks, payment instructions and UTC daily reset. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows (reset in seconds)." }, "503": { "description": "Provider unavailable or exhausted budget; no payment settlement" } } ``` - [GET /v1/payouts](https://stonkfun.x4o2.com/v1/payouts): Verified protocol claim transfers and fee accrual events (0.001 USD via x402) Request body: ```json {} ``` Parameters: ```json [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page size", "minimum": 1, "maximum": 100, "default": 20 }, "description": "Page size", "example": "1" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Offset", "minimum": 0, "maximum": 250000, "default": 0 }, "description": "Offset" }, { "name": "mint", "in": "query", "required": false, "schema": { "type": "string", "description": "Exact Solana token mint" }, "description": "Exact Solana token mint" } ] ``` Responses (schemas and captured examples): ```json { "200": { "description": "Verified observations; inspect meta and coverage for freshness and partial history", "content": { "application/json": { "schema": { "type": [ "object", "null" ], "properties": { "data": { "type": [ "object", "null" ], "properties": { "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "signature": { "type": [ "string", "null" ] }, "slot": { "type": [ "number", "null" ] }, "quoteMint": { "type": [ "string", "null" ] }, "protocolFeeRaw": { "type": [ "string", "null" ] }, "platformFeeRaw": { "type": [ "string", "null" ] }, "creatorFeeRaw": { "type": [ "string", "null" ] }, "shareFeeRaw": { "type": [ "string", "null" ] }, "quoteDecimals": { "type": [ "number", "null" ] }, "kind": { "type": [ "string", "null" ] }, "observedAt": { "type": [ "string", "null" ] } } } }, "limit": { "type": [ "number", "null" ] }, "offset": { "type": [ "number", "null" ] }, "rewardDistributions": {}, "partial": { "type": [ "boolean", "null" ] }, "coverage": { "type": [ "string", "null" ] } } }, "meta": { "type": [ "object", "null" ], "properties": { "observedAt": { "type": [ "number", "null" ] }, "ageMs": { "type": [ "number", "null" ] }, "source": { "type": [ "string", "null" ] }, "partial": { "type": [ "boolean", "null" ] }, "commitment": { "type": [ "string", "null" ] }, "freshnessSeconds": { "type": [ "number", "null" ] }, "discoveryAt": { "type": [ "string", "null" ] } } } } }, "example": { "data": { "items": [ { "signature": "2GMSptzLTmsUuhz9ZbcCAYiiPGyXDKMXPKrvi1h7Y9vkZ7PL1WMLDScNVPxa2VGapMQKeeShYcgw1eXEZqP6D5a9", "slot": 463567913, "quoteMint": "XsoCS1TfEyfFhfvj8EtZ528L3CaKBDBRqRapnBbDF2W", "protocolFeeRaw": "7284", "platformFeeRaw": "29132", "creatorFeeRaw": "0", "shareFeeRaw": "0", "quoteDecimals": 8, "kind": "fees", "observedAt": "2026-10-31T05:18:10.000Z" } ], "limit": 1, "offset": 0, "rewardDistributions": null, "partial": true, "coverage": "Observed protocol fee accruals and verified claim transfers only; no inferred holder reward yield." }, "meta": { "observedAt": 1793423890000, "ageMs": 428868, "source": "stale", "partial": true, "commitment": "finalized", "freshnessSeconds": 120, "discoveryAt": "2026-10-31T05:25:18.367Z" } } } } }, "400": { "description": "Invalid or unknown query" }, "402": { "description": "Pay with x402; the x4o2-free-key extension describes signup and Authorization" }, "404": { "description": "Unknown token or exact market" }, "429": { "description": "Free-key quota or pause: Retry-After, docs Link and upgrade object with price, networks, payment instructions and UTC daily reset. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows (reset in seconds)." }, "503": { "description": "Provider unavailable or exhausted budget; no payment settlement" } } ``` - [GET /v1/rewards](https://stonkfun.x4o2.com/v1/rewards): Observed fee events; holder reward distributions unknown (0.001 USD via x402) Request body: ```json {} ``` Parameters: ```json [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "description": "Page size", "minimum": 1, "maximum": 100, "default": 20 }, "description": "Page size", "example": "1" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "description": "Offset", "minimum": 0, "maximum": 250000, "default": 0 }, "description": "Offset" }, { "name": "mint", "in": "query", "required": false, "schema": { "type": "string", "description": "Exact Solana token mint" }, "description": "Exact Solana token mint" } ] ``` Responses (schemas and captured examples): ```json { "200": { "description": "Verified observations; inspect meta and coverage for freshness and partial history", "content": { "application/json": { "schema": { "type": [ "object", "null" ], "properties": { "data": { "type": [ "object", "null" ], "properties": { "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "signature": { "type": [ "string", "null" ] }, "slot": { "type": [ "number", "null" ] }, "quoteMint": { "type": [ "string", "null" ] }, "protocolFeeRaw": { "type": [ "string", "null" ] }, "platformFeeRaw": { "type": [ "string", "null" ] }, "creatorFeeRaw": { "type": [ "string", "null" ] }, "shareFeeRaw": { "type": [ "string", "null" ] }, "quoteDecimals": { "type": [ "number", "null" ] }, "kind": { "type": [ "string", "null" ] }, "observedAt": { "type": [ "string", "null" ] } } } }, "limit": { "type": [ "number", "null" ] }, "offset": { "type": [ "number", "null" ] }, "rewardDistributions": {}, "partial": { "type": [ "boolean", "null" ] }, "coverage": { "type": [ "string", "null" ] } } }, "meta": { "type": [ "object", "null" ], "properties": { "observedAt": { "type": [ "number", "null" ] }, "ageMs": { "type": [ "number", "null" ] }, "source": { "type": [ "string", "null" ] }, "partial": { "type": [ "boolean", "null" ] }, "commitment": { "type": [ "string", "null" ] }, "freshnessSeconds": { "type": [ "number", "null" ] }, "discoveryAt": { "type": [ "string", "null" ] } } } } }, "example": { "data": { "items": [ { "signature": "2GMSptzLTmsUuhz9ZbcCAYiiPGyXDKMXPKrvi1h7Y9vkZ7PL1WMLDScNVPxa2VGapMQKeeShYcgw1eXEZqP6D5a9", "slot": 463567913, "quoteMint": "XsoCS1TfEyfFhfvj8EtZ528L3CaKBDBRqRapnBbDF2W", "protocolFeeRaw": "7284", "platformFeeRaw": "29132", "creatorFeeRaw": "0", "shareFeeRaw": "0", "quoteDecimals": 8, "kind": "fees", "observedAt": "2026-10-31T05:18:10.000Z" } ], "limit": 1, "offset": 0, "rewardDistributions": null, "partial": true, "coverage": "Observed protocol fee accruals and verified claim transfers only; no inferred holder reward yield." }, "meta": { "observedAt": 1793423890000, "ageMs": 428892, "source": "stale", "partial": true, "commitment": "finalized", "freshnessSeconds": 120, "discoveryAt": "2026-10-31T05:25:18.367Z" } } } } }, "400": { "description": "Invalid or unknown query" }, "402": { "description": "Pay with x402; the x4o2-free-key extension describes signup and Authorization" }, "404": { "description": "Unknown token or exact market" }, "429": { "description": "Free-key quota or pause: Retry-After, docs Link and upgrade object with price, networks, payment instructions and UTC daily reset. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows (reset in seconds)." }, "503": { "description": "Provider unavailable or exhausted budget; no payment settlement" } } ``` - [GET /v1/stats](https://stonkfun.x4o2.com/v1/stats): Protocol coverage, pool counts and ingestion freshness (0.001 USD via x402) Request body: ```json {} ``` Parameters: ```json [] ``` Responses (schemas and captured examples): ```json { "200": { "description": "Verified observations; inspect meta and coverage for freshness and partial history", "content": { "application/json": { "schema": { "type": [ "object", "null" ], "properties": { "data": { "type": [ "object", "null" ], "properties": { "platformConfigs": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] } }, "tokens": { "type": [ "number", "null" ] }, "pools": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "properties": { "kind": { "type": [ "string", "null" ] }, "lifecycle": { "type": [ "string", "null" ] }, "count": { "type": [ "number", "null" ] } } } }, "pairings": { "type": [ "number", "null" ] }, "pendingTransactions": { "type": [ "number", "null" ] }, "lastChainAt": { "type": [ "string", "null" ] }, "lastReceiptAt": { "type": [ "string", "null" ] }, "fullScanAt": {}, "gapAt": {}, "revenueUsd": {}, "totalHolders": {}, "partial": { "type": [ "boolean", "null" ] } } }, "meta": { "type": [ "object", "null" ], "properties": { "observedAt": { "type": [ "number", "null" ] }, "ageMs": { "type": [ "number", "null" ] }, "source": { "type": [ "string", "null" ] }, "partial": { "type": [ "boolean", "null" ] }, "commitment": { "type": [ "string", "null" ] }, "freshnessSeconds": { "type": [ "number", "null" ] }, "discoveryAt": { "type": [ "string", "null" ] } } } } }, "example": { "data": { "platformConfigs": [ "4E876qZTE9FJMrBzgVtBrSrzz2TLivB5Y5QXPjB4gZL7", "6BwHHDg3u1854jC8PDLXvR4spTcLNaoBxLJNGC4nTESt" ], "tokens": 12212, "pools": [ { "kind": "cpmm", "lifecycle": "graduated", "count": 4 }, { "kind": "launchlab", "lifecycle": "bonding", "count": 12208 }, { "kind": "launchlab", "lifecycle": "graduated", "count": 4 } ], "pairings": 397, "pendingTransactions": 501, "lastChainAt": "2026-10-31T05:18:10.000Z", "lastReceiptAt": "2026-10-31T05:25:06.251Z", "fullScanAt": null, "gapAt": null, "revenueUsd": null, "totalHolders": null, "partial": true }, "meta": { "observedAt": 1793424318367, "ageMs": 620, "source": "cache", "partial": true, "commitment": "finalized", "freshnessSeconds": 120, "discoveryAt": "2026-10-31T05:25:18.367Z" } } } } }, "400": { "description": "Invalid or unknown query" }, "402": { "description": "Pay with x402; the x4o2-free-key extension describes signup and Authorization" }, "404": { "description": "Unknown token or exact market" }, "429": { "description": "Free-key quota or pause: Retry-After, docs Link and upgrade object with price, networks, payment instructions and UTC daily reset. Free-key responses include RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset for minute and day windows (reset in seconds)." }, "503": { "description": "Provider unavailable or exhausted budget; no payment settlement" } } ```