{"openapi":"3.1.0","info":{"title":"Base Token Snapshot and Share Card API","version":"1.1.0","description":"Base ERC-20 token market snapshot: up to ten DEX Screener trading pairs ranked by USD liquidity, with pair price quotes, 24-hour volume and buy/sell counts, price changes, on-chain contract metadata, and GoPlus risk flags, buy/sell/transfer taxes, and reported largest-holder shares. Sources and retrieval times are included. Missing or unavailable data is not evidence of safety; this API gives no composite verdict or investment recommendation. US$0.01 per call.","x-guidance":"Use GET or POST /api/base/token-snapshot for market and contract data ($0.01), or GET /api/base/token-card?token=0x… / POST /api/base/token-card for a rule-generated share card ($0.02). Both use USDC on Base."},"servers":[{"url":"https://base-token-snapshot-20261010.genial-clove-9914.chatgpt.site"}],"externalDocs":{"description":"API documentation, examples, and schemas.","url":"https://base-token-snapshot-20261010.genial-clove-9914.chatgpt.site"},"paths":{"/api/base/token-card":{"get":{"operationId":"getBaseTokenShareCardByQuery","summary":"Create a shareable SVG card from public Base token market facts","description":"A rule-generated, shareable SVG summary of public Base ERC-20 contract facts and the most liquid indexed DEX pair. It only attributes price change to the token when it is the pair's base token. The card is for entertainment and sharing, not a safety verdict, forecast, or investment recommendation. US$0.02 per request.","security":[{"x402Payment":[]}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":["x402"]},"x402":{"scheme":"exact","network":"eip155:8453","asset":"USDC","priceUsd":"0.02","payTo":"0xe41dd3a10f0e4158f26de742fae2bf0b2796f41c","facilitator":"https://facilitator.payai.network"},"parameters":[{"name":"token","in":"query","required":true,"description":"Base ERC-20 contract address.","schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Base ERC-20 contract address.","example":"0x4200000000000000000000000000000000000006"}}],"responses":{"200":{"description":"Rule-generated SVG card and traceable market facts after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","required":["schemaVersion","kind","chain","tokenAddress","token","headline","caption","facts","sources","retrievedAt","disclaimer","shareCardSvg"],"properties":{"schemaVersion":{"type":"string","const":"1.0.0"},"kind":{"type":"string","const":"rule_generated_market_share_card"},"chain":{"type":"string","const":"base"},"tokenAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"token":{"type":"object","required":["name","symbol"],"properties":{"name":{"type":"string"},"symbol":{"type":"string"}}},"headline":{"type":"string"},"caption":{"type":"string"},"facts":{"type":"object","properties":{"mostLiquidIndexedPair":{"anyOf":[{"type":"null"},{"type":"object","required":["dex","tokenSide","liquidityUsd","pairVolume24hUsd","tokenPriceUsd","tokenPriceChange24hPercent","displayedPriceChange"],"properties":{"dex":{"type":"string"},"pairAddress":{"type":["string","null"]},"url":{"type":["string","null"]},"tokenSide":{"type":"string","enum":["base","quote"]},"liquidityUsd":{"type":["number","null"]},"pairVolume24hUsd":{"type":["number","null"]},"tokenPriceUsd":{"type":["string","null"]},"tokenPriceChange24hPercent":{"type":["number","null"]},"displayedPriceChange":{"type":"string"}}}]},"indexedPairCount":{"type":"integer","minimum":0}}},"sources":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"}}}},"retrievedAt":{"type":"string","format":"date-time"},"disclaimer":{"type":"string"},"shareCardSvg":{"type":"string","description":"Self-contained XML-escaped SVG share card."}}}}}},"400":{"description":"Invalid or missing token query parameter."},"402":{"description":"USDC payment required on Base.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"Base64-encoded x402 v2 payment requirements."},"X-Payment-Required":{"schema":{"type":"string"},"description":"Compatibility alias for clients expecting the X-prefixed payment challenge header."}}}}},"post":{"operationId":"getBaseTokenShareCard","summary":"Create a shareable SVG card from public Base token market facts","description":"A rule-generated, shareable SVG summary of public Base ERC-20 contract facts and the most liquid indexed DEX pair. It only attributes price change to the token when it is the pair's base token. The card is for entertainment and sharing, not a safety verdict, forecast, or investment recommendation. US$0.02 per request.","security":[{"x402Payment":[]}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":["x402"]},"x402":{"scheme":"exact","network":"eip155:8453","asset":"USDC","priceUsd":"0.02","payTo":"0xe41dd3a10f0e4158f26de742fae2bf0b2796f41c","facilitator":"https://facilitator.payai.network"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["token"],"properties":{"token":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Base ERC-20 contract address.","example":"0x4200000000000000000000000000000000000006"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Rule-generated SVG card and traceable market facts after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","required":["schemaVersion","kind","chain","tokenAddress","token","headline","caption","facts","sources","retrievedAt","disclaimer","shareCardSvg"],"properties":{"schemaVersion":{"type":"string","const":"1.0.0"},"kind":{"type":"string","const":"rule_generated_market_share_card"},"chain":{"type":"string","const":"base"},"tokenAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"token":{"type":"object","required":["name","symbol"],"properties":{"name":{"type":"string"},"symbol":{"type":"string"}}},"headline":{"type":"string"},"caption":{"type":"string"},"facts":{"type":"object","properties":{"mostLiquidIndexedPair":{"anyOf":[{"type":"null"},{"type":"object","required":["dex","tokenSide","liquidityUsd","pairVolume24hUsd","tokenPriceUsd","tokenPriceChange24hPercent","displayedPriceChange"],"properties":{"dex":{"type":"string"},"pairAddress":{"type":["string","null"]},"url":{"type":["string","null"]},"tokenSide":{"type":"string","enum":["base","quote"]},"liquidityUsd":{"type":["number","null"]},"pairVolume24hUsd":{"type":["number","null"]},"tokenPriceUsd":{"type":["string","null"]},"tokenPriceChange24hPercent":{"type":["number","null"]},"displayedPriceChange":{"type":"string"}}}]},"indexedPairCount":{"type":"integer","minimum":0}}},"sources":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"}}}},"retrievedAt":{"type":"string","format":"date-time"},"disclaimer":{"type":"string"},"shareCardSvg":{"type":"string","description":"Self-contained XML-escaped SVG share card."}}}}}},"400":{"description":"Malformed JSON or invalid token address."},"402":{"description":"USDC payment required on Base.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"Base64-encoded x402 v2 payment requirements."},"X-Payment-Required":{"schema":{"type":"string"},"description":"Compatibility alias for clients expecting the X-prefixed payment challenge header."}}}}}},"/api/base/token-snapshot":{"get":{"operationId":"getBaseTokenSnapshotByQuery","summary":"Base token DEX prices, liquidity, 24-hour volume, metadata, and GoPlus risk flags","description":"Base ERC-20 token market snapshot: up to ten DEX Screener trading pairs ranked by USD liquidity, with pair price quotes, 24-hour volume and buy/sell counts, price changes, on-chain contract metadata, and GoPlus risk flags, buy/sell/transfer taxes, and reported largest-holder shares. Sources and retrieval times are included. Missing or unavailable data is not evidence of safety; this API gives no composite verdict or investment recommendation. US$0.01 per call.","security":[{"x402Payment":[]}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":["x402"]},"x402":{"scheme":"exact","network":"eip155:8453","asset":"USDC","priceUsd":"0.01","payTo":"0xe41dd3a10f0e4158f26de742fae2bf0b2796f41c","facilitator":"https://facilitator.payai.network"},"parameters":[{"name":"token","in":"query","required":true,"description":"Base ERC-20 contract address.","schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Base ERC-20 contract address.","example":"0x4200000000000000000000000000000000000006"}}],"responses":{"200":{"description":"DEX market pairs, public Base ERC-20 contract data, and third-party security observations after successful x402 payment. Security data may be missing or delayed and does not establish that a token is safe.","content":{"application/json":{"schema":{"type":"object","required":["schemaVersion","chain","tokenAddress","retrievedAt","market","contract","security","sources","notes"],"properties":{"schemaVersion":{"type":"string","const":"1.1.0"},"chain":{"type":"string","const":"base"},"tokenAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"retrievedAt":{"type":"string","format":"date-time"},"market":{"type":"object","required":["status","pairCount","pairs"],"properties":{"status":{"type":"string","enum":["available","no_pairs","unavailable"]},"pairCount":{"type":"integer","minimum":0},"pairs":{"type":"array","items":{"type":"object","required":["dex","pairAddress","pairUrl","tokenSide","quoteToken","priceUsd","liquidityUsd","volume24hUsd","buys24h","sells24h","priceChange24hPercent","fdvUsd","marketCapUsd","pairCreatedAt"],"properties":{"dex":{"type":["string","null"]},"pairAddress":{"type":["string","null"]},"pairUrl":{"type":["string","null"]},"tokenSide":{"type":"string","enum":["base","quote"]},"quoteToken":{"type":["object","null"],"properties":{"address":{"type":["string","null"]},"name":{"type":["string","null"]},"symbol":{"type":["string","null"]}}},"priceUsd":{"type":["string","null"]},"liquidityUsd":{"type":["number","null"]},"volume24hUsd":{"type":["number","null"]},"buys24h":{"type":["number","null"]},"sells24h":{"type":["number","null"]},"priceChange24hPercent":{"type":["number","null"]},"fdvUsd":{"type":["number","null"]},"marketCapUsd":{"type":["number","null"]},"pairCreatedAt":{"type":["string","null"],"format":"date-time"}}}}}},"contract":{"type":"object","required":["status","blockNumber","hasCode","codeBytes","name","symbol","decimals","totalSupplyRaw","totalSupply"],"properties":{"status":{"type":"string","enum":["available","partial","unavailable"]},"blockNumber":{"type":["string","null"]},"hasCode":{"type":["boolean","null"]},"codeBytes":{"type":["integer","null"],"minimum":0},"name":{"type":["string","null"]},"symbol":{"type":["string","null"]},"decimals":{"type":["integer","null"],"minimum":0,"maximum":36},"totalSupplyRaw":{"type":["string","null"]},"totalSupply":{"type":["string","null"]}}},"security":{"type":"object","description":"GoPlus Token Security observations; missing or zero flags do not prove a token is safe.","required":["status","provider","chainId","retrievedAt","signals","taxes","holders"],"properties":{"status":{"type":"string","enum":["available","no_record","unavailable"]},"provider":{"type":"string","const":"GoPlus Security"},"chainId":{"type":"string","const":"8453"},"retrievedAt":{"type":["string","null"],"format":"date-time"},"tokenName":{"type":["string","null"]},"tokenSymbol":{"type":["string","null"]},"signals":{"type":"object","properties":{"isOpenSource":{"type":["string","null"]},"isHoneypot":{"type":["string","null"]},"isMintable":{"type":["string","null"]},"isProxy":{"type":["string","null"]},"hasHiddenOwner":{"type":["string","null"]},"isBlacklisted":{"type":["string","null"]},"canTakeBackOwnership":{"type":["string","null"]},"ownerCanChangeBalance":{"type":["string","null"]},"transferPausable":{"type":["string","null"]},"personalSlippageModifiable":{"type":["string","null"]},"slippageModifiable":{"type":["string","null"]}}},"taxes":{"type":"object","properties":{"buy":{"type":["string","null"]},"sell":{"type":["string","null"]},"transfer":{"type":["string","null"]}}},"holders":{"type":"object","properties":{"reportedCount":{"type":["string","null"]},"largestReported":{"type":"array","items":{"type":"object","properties":{"address":{"type":["string","null"]},"shareFraction":{"type":["string","null"]},"isContract":{"type":["number","null"]},"tag":{"type":["string","null"]}}}}}}}},"sources":{"type":"array","items":{"type":"object","required":["name","url"],"properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"}}}},"notes":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Invalid or missing token query parameter."},"402":{"description":"USDC payment required on Base.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"Base64-encoded x402 v2 payment requirements."},"X-Payment-Required":{"schema":{"type":"string"},"description":"Compatibility alias for clients expecting the X-prefixed payment challenge header."}}}}},"post":{"operationId":"getBaseTokenSnapshot","summary":"Base token DEX prices, liquidity, 24-hour volume, metadata, and GoPlus risk flags","description":"Base ERC-20 token market snapshot: up to ten DEX Screener trading pairs ranked by USD liquidity, with pair price quotes, 24-hour volume and buy/sell counts, price changes, on-chain contract metadata, and GoPlus risk flags, buy/sell/transfer taxes, and reported largest-holder shares. Sources and retrieval times are included. Missing or unavailable data is not evidence of safety; this API gives no composite verdict or investment recommendation. US$0.01 per call.","security":[{"x402Payment":[]}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":["x402"]},"x402":{"scheme":"exact","network":"eip155:8453","asset":"USDC","priceUsd":"0.01","payTo":"0xe41dd3a10f0e4158f26de742fae2bf0b2796f41c","facilitator":"https://facilitator.payai.network"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["token"],"properties":{"token":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Base ERC-20 contract address.","example":"0x4200000000000000000000000000000000000006"}},"additionalProperties":false}}}},"responses":{"200":{"description":"DEX market pairs, public Base ERC-20 contract data, and third-party security observations after successful x402 payment. Security data may be missing or delayed and does not establish that a token is safe.","content":{"application/json":{"schema":{"type":"object","required":["schemaVersion","chain","tokenAddress","retrievedAt","market","contract","security","sources","notes"],"properties":{"schemaVersion":{"type":"string","const":"1.1.0"},"chain":{"type":"string","const":"base"},"tokenAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"retrievedAt":{"type":"string","format":"date-time"},"market":{"type":"object","required":["status","pairCount","pairs"],"properties":{"status":{"type":"string","enum":["available","no_pairs","unavailable"]},"pairCount":{"type":"integer","minimum":0},"pairs":{"type":"array","items":{"type":"object","required":["dex","pairAddress","pairUrl","tokenSide","quoteToken","priceUsd","liquidityUsd","volume24hUsd","buys24h","sells24h","priceChange24hPercent","fdvUsd","marketCapUsd","pairCreatedAt"],"properties":{"dex":{"type":["string","null"]},"pairAddress":{"type":["string","null"]},"pairUrl":{"type":["string","null"]},"tokenSide":{"type":"string","enum":["base","quote"]},"quoteToken":{"type":["object","null"],"properties":{"address":{"type":["string","null"]},"name":{"type":["string","null"]},"symbol":{"type":["string","null"]}}},"priceUsd":{"type":["string","null"]},"liquidityUsd":{"type":["number","null"]},"volume24hUsd":{"type":["number","null"]},"buys24h":{"type":["number","null"]},"sells24h":{"type":["number","null"]},"priceChange24hPercent":{"type":["number","null"]},"fdvUsd":{"type":["number","null"]},"marketCapUsd":{"type":["number","null"]},"pairCreatedAt":{"type":["string","null"],"format":"date-time"}}}}}},"contract":{"type":"object","required":["status","blockNumber","hasCode","codeBytes","name","symbol","decimals","totalSupplyRaw","totalSupply"],"properties":{"status":{"type":"string","enum":["available","partial","unavailable"]},"blockNumber":{"type":["string","null"]},"hasCode":{"type":["boolean","null"]},"codeBytes":{"type":["integer","null"],"minimum":0},"name":{"type":["string","null"]},"symbol":{"type":["string","null"]},"decimals":{"type":["integer","null"],"minimum":0,"maximum":36},"totalSupplyRaw":{"type":["string","null"]},"totalSupply":{"type":["string","null"]}}},"security":{"type":"object","description":"GoPlus Token Security observations; missing or zero flags do not prove a token is safe.","required":["status","provider","chainId","retrievedAt","signals","taxes","holders"],"properties":{"status":{"type":"string","enum":["available","no_record","unavailable"]},"provider":{"type":"string","const":"GoPlus Security"},"chainId":{"type":"string","const":"8453"},"retrievedAt":{"type":["string","null"],"format":"date-time"},"tokenName":{"type":["string","null"]},"tokenSymbol":{"type":["string","null"]},"signals":{"type":"object","properties":{"isOpenSource":{"type":["string","null"]},"isHoneypot":{"type":["string","null"]},"isMintable":{"type":["string","null"]},"isProxy":{"type":["string","null"]},"hasHiddenOwner":{"type":["string","null"]},"isBlacklisted":{"type":["string","null"]},"canTakeBackOwnership":{"type":["string","null"]},"ownerCanChangeBalance":{"type":["string","null"]},"transferPausable":{"type":["string","null"]},"personalSlippageModifiable":{"type":["string","null"]},"slippageModifiable":{"type":["string","null"]}}},"taxes":{"type":"object","properties":{"buy":{"type":["string","null"]},"sell":{"type":["string","null"]},"transfer":{"type":["string","null"]}}},"holders":{"type":"object","properties":{"reportedCount":{"type":["string","null"]},"largestReported":{"type":"array","items":{"type":"object","properties":{"address":{"type":["string","null"]},"shareFraction":{"type":["string","null"]},"isContract":{"type":["number","null"]},"tag":{"type":["string","null"]}}}}}}}},"sources":{"type":"array","items":{"type":"object","required":["name","url"],"properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"}}}},"notes":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Malformed JSON or invalid token address."},"402":{"description":"USDC payment required on Base.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"Base64-encoded x402 v2 payment requirements."},"X-Payment-Required":{"schema":{"type":"string"},"description":"Compatibility alias for clients expecting the X-prefixed payment challenge header."}}}}}},"/api/health":{"get":{"operationId":"health","security":[],"responses":{"200":{"description":"Service is available."}}}}},"components":{"securitySchemes":{"x402Payment":{"type":"apiKey","in":"header","name":"PAYMENT-SIGNATURE","description":"x402 v2 payment payload. An initial request without this header receives the payment challenge."}}},"x-x402":{"protocolVersion":2,"network":"eip155:8453","scheme":"exact","price":"$0.01","payTo":"0xe41dd3a10f0e4158f26de742fae2bf0b2796f41c","facilitator":"https://facilitator.payai.network","endpoint":"https://base-token-snapshot-20261010.genial-clove-9914.chatgpt.site/api/base/token-snapshot","endpoints":[{"endpoint":"https://base-token-snapshot-20261010.genial-clove-9914.chatgpt.site/api/base/token-card","methods":["GET","POST"],"price":"$0.02"}]}}