{"uid":"cap_jQUfcmejgk8tvJTD846_O","slug":"plainchain-token-data-endpoint-fd78c3de","name":"Plainchain Token Data Endpoint","description":"Gas, balances, token data, address type, approvals, transaction decoding, x402 receipt verification and verifiable randomness on Base, Arbitrum, Ethereum and Optimism. No API key: pay $0.001-$0.01 per call in USDC on Base via x402.","url":"https://plainchain.appin60.com/v1/token?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"},"queryParams":{"type":"object","required":["address"],"properties":{"chain":{"type":"string","description":"base (default), arbitrum, ethereum or optimism; chain ids 8453, 42161, 1, 10 also work"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"token contract address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"name":"Degen","chain":"Base","market":{"priceUsd":0.00099,"volume24hUsd":32314,"oldestPairCreated":"2024-01-08T00:00:00.000Z","priceChange24hPct":-2.1,"liquidityUsdAllPairs":113268},"symbol":"DEGEN","address":"0x4ed4e862860bed51a9570b96d89af5e1b0efefed","decimals":18,"totalSupply":"36965840682.5"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001942","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.001942/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001942","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001942","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_348v47xgdmBxtK6U52AMn","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001942","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns on-chain token metadata and market data (name, symbol, decimals, supply, price, volume, liquidity) for a given ERC-20 contract address on Base, Arbitrum, Ethereum, or Optimism","exampleAgentPrompt":"What's the current price, symbol, and 24-hour trading volume for the token at contract address 0x4ed4e862860bed51a9570b96d89af5e1b0efefed on Base?","exampleUseCases":[{"title":"DeFi portfolio token price check","prompt":"Can you look up the current USD price and 24-hour volume for the token at 0x4ed4e862860bed51a9570b96d89af5e1b0efefed on Base so I know if it's worth trading right now?"},{"title":"Token decimals for contract integration","prompt":"I need the symbol, decimals, and total supply for the token contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum — I'm building a contract that needs to handle it correctly."},{"title":"Arbitrum token liquidity research","prompt":"What's the liquidity and market data for the token at 0xff970a61a04b1ca14834a43f5de4533ebddb5cc8 on Arbitrum — I want to know if there's enough depth to trade it."}],"resultDescription":"A JSON object containing the token's name, symbol, contract address, chain, decimals, total supply, and market data including USD price, 24-hour volume in USD, price change percentage over 24 hours, total liquidity across all pairs in USD, and the oldest pair creation date.","failureModes":["Invalid or non-ERC-20 contract address returns an error or empty result","Unsupported chain identifier returns a validation error","Token with no DEX liquidity may return null or missing market fields","Payment failure via x402 (insufficient USDC balance) blocks the request","Rate limiting or network issues on the target chain may cause timeouts"],"whenToPreferThis":"Use this endpoint when you need token metadata and market data (price, volume, liquidity) for an ERC-20 contract on Base, Arbitrum, Ethereum, or Optimism and want pay-per-call access without managing an API key subscription. It is especially suited for AI agents that need on-demand token lookups billed in micro-USDC via the x402 protocol.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T12:39:32.915Z","isFirstParty":false,"canonicalSlug":"plainchain-token-data-endpoint-fd78c3de"}