{"openapi":"3.1.0","info":{"title":"Mint Facts: Solana token mint facts","version":"1.1.0","description":"Facts-only on-chain data for Solana SPL token mints, pay-per-call with x402 USDC on Base. Automated facts read from the Solana blockchain at the time shown. Not financial advice. Not a safety rating, verdict or recommendation. A mint with no flags can still be a bad token.","x-guidance":"Use GET /check?mint=<mint> ($0.02) for authorities, supply, decimals, Token-2022 extensions and factual flags; GET /holders?mint=<mint> ($0.20) for holder concentration with known pool/burn accounts excluded; GET /check-batch?mints=a,b,c ($0.08, up to 10). GET /lite?mint=<mint> is free and rate limited. Responses are facts and flags only: never a safety verdict, never financial advice. You are only charged for 200 responses."},"servers":[{"url":"https://mint-facts.mintfacts.workers.dev"}],"paths":{"/lite":{"get":{"operationId":"lite_check","summary":"Free: mint authority, freeze authority, supply, decimals","description":"Use this when you want a quick free look at a Solana token mint: mint authority, freeze authority, supply and decimals. Rate limited. Facts only, not financial advice.","tags":["Solana token facts"],"parameters":[{"name":"mint","in":"query","required":true,"schema":{"type":"string","minLength":32,"maxLength":44,"description":"Solana SPL token mint address (base58)","example":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"},"description":"Solana SPL token mint address (base58)"}],"responses":{"200":{"description":"Facts as JSON","content":{"application/json":{"schema":{"type":"object","properties":{"mint":{"type":"string"},"checked_at":{"type":"string"},"token_program":{"type":"string"},"decimals":{"type":"integer"},"supply":{"type":"object"},"mint_authority":{"type":["string","null"]},"freeze_authority":{"type":["string","null"]},"disclaimer":{"type":"string"}},"required":["mint","mint_authority","freeze_authority","supply","disclaimer"]},"example":{"mint":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","checked_at":"2026-11-18T23:00:00.000Z","token_program":"spl-token","decimals":6,"supply":{"raw":"0","ui":0},"mint_authority":"<address or null>","freeze_authority":"<address or null>","disclaimer":"Automated facts read from the Solana blockchain at the time shown. Not financial advice. Not a safety rating, verdict or recommendation. A mint with no flags can still be a bad token."}}}},"400":{"description":"Malformed input (never charged)"},"422":{"description":"Address is not a usable mint (never charged)"},"429":{"description":"Rate limited"},"503":{"description":"Upstream data unavailable (never charged)"}},"security":[]}},"/check":{"get":{"operationId":"check_mint","summary":"Full on-chain facts for one Solana token mint","description":"Use this when you need on-chain facts about a Solana SPL token mint before interacting with it: mint and freeze authority, supply, decimals, Token-2022 extensions (transfer fee, permanent delegate, transfer hook...) and factual flags. Facts only, no verdict. Automated facts, not financial advice.","tags":["Solana token facts"],"parameters":[{"name":"mint","in":"query","required":true,"schema":{"type":"string","minLength":32,"maxLength":44,"description":"Solana SPL token mint address (base58)","example":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"},"description":"Solana SPL token mint address (base58)"}],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.020000"}},"responses":{"200":{"description":"Facts as JSON","content":{"application/json":{"schema":{"type":"object","properties":{"mint":{"type":"string"},"checked_at":{"type":"string"},"token_program":{"type":"string"},"decimals":{"type":"integer"},"supply":{"type":"object"},"is_initialized":{"type":"boolean"},"mint_authority":{"type":["string","null"]},"freeze_authority":{"type":["string","null"]},"token2022_extensions":{"type":"array"},"flags":{"type":"array","items":{"type":"string"}},"disclaimer":{"type":"string"}},"required":["mint","flags","disclaimer"]},"example":{"mint":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","checked_at":"2026-11-18T23:00:00.000Z","token_program":"spl-token","decimals":6,"supply":{"raw":"0","ui":0},"is_initialized":true,"mint_authority":"<address or null>","freeze_authority":"<address or null>","token2022_extensions":[],"flags":["mint_authority_present"],"disclaimer":"Automated facts read from the Solana blockchain at the time shown. Not financial advice. Not a safety rating, verdict or recommendation. A mint with no flags can still be a bad token."}}}},"400":{"description":"Malformed input (never charged)"},"402":{"description":"Payment Required (x402 v2, PAYMENT-REQUIRED header)"},"422":{"description":"Address is not a usable mint (never charged)"},"503":{"description":"Upstream data unavailable (never charged)"}}}},"/holders":{"get":{"operationId":"holders_pack","summary":"Holder concentration pack for one Solana token mint","description":"Use this when you need holder concentration for a Solana token mint: share of supply held by the top 1/5/10/20 largest token accounts, with known liquidity-pool, bonding-curve and burn accounts identified and excluded where determinable. Facts only, no verdict. Automated facts, not financial advice.","tags":["Solana token facts"],"parameters":[{"name":"mint","in":"query","required":true,"schema":{"type":"string","minLength":32,"maxLength":44,"description":"Solana SPL token mint address (base58)","example":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"},"description":"Solana SPL token mint address (base58)"}],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.200000"}},"responses":{"200":{"description":"Facts as JSON","content":{"application/json":{"schema":{"type":"object","properties":{"mint":{"type":"string"},"raw":{"type":"object"},"excluded":{"type":"array"},"excluding_pool_burn":{"type":"object"},"top_accounts":{"type":"array"},"flags":{"type":"array","items":{"type":"string"}},"disclaimer":{"type":"string"}},"required":["mint","raw","disclaimer"]},"example":{"mint":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","checked_at":"2026-11-18T23:00:00.000Z","supply":{"raw":"0","ui":0},"raw":{"top1_pct":0,"top5_pct":0,"top10_pct":0,"top20_pct":0},"excluded":[],"excluding_pool_burn":{"top1_pct":0,"top5_pct":0,"top10_pct":0},"top_accounts":[],"flags":[],"disclaimer":"Automated facts read from the Solana blockchain at the time shown. Not financial advice. Not a safety rating, verdict or recommendation. A mint with no flags can still be a bad token."}}}},"400":{"description":"Malformed input (never charged)"},"402":{"description":"Payment Required (x402 v2, PAYMENT-REQUIRED header)"},"422":{"description":"Address is not a usable mint (never charged)"},"503":{"description":"Upstream data unavailable (never charged)"}}}},"/check-batch":{"get":{"operationId":"check_batch","summary":"Full on-chain facts for up to 10 Solana token mints in one call","description":"Use this when you need the /check facts for up to 10 Solana token mints in one call (comma-separated mints). All-or-nothing: if any mint fails you are not charged. Facts only, not financial advice.","tags":["Solana token facts"],"parameters":[{"name":"mints","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated Solana mint addresses, 1 to 10"},"description":"Comma-separated Solana mint addresses, 1 to 10"}],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.080000"}},"responses":{"200":{"description":"Facts as JSON","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"results":{"type":"array","items":{"type":"object"}},"disclaimer":{"type":"string"}},"required":["results","disclaimer"]},"example":{"count":1,"results":[{"mint":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","flags":[]}],"disclaimer":"Automated facts read from the Solana blockchain at the time shown. Not financial advice. Not a safety rating, verdict or recommendation. A mint with no flags can still be a bad token."}}}},"400":{"description":"Malformed input (never charged)"},"402":{"description":"Payment Required (x402 v2, PAYMENT-REQUIRED header)"},"422":{"description":"Address is not a usable mint (never charged)"},"503":{"description":"Upstream data unavailable (never charged)"}}}},"/sample":{"get":{"operationId":"sample","summary":"Free example outputs (real, labeled)","security":[],"responses":{"200":{"description":"Examples"}}}}},"x-x402":{"network":"eip155:8453","asset":"USDC","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402","payTo":"0x59D0D643f1c91ACa0B1dcd4bE20edF188645845f","mcp":"https://mint-facts.mintfacts.workers.dev/mcp"}}