{"uid":"cap_prJgc1IAOESrOAYfFZTdA","slug":"2s-io-on-chain-token-info-geckoterminal-a703e8c8","name":"2s.io On-Chain Token Info (GeckoTerminal)","description":"On-chain token metrics by contract address (via GeckoTerminal, free/keyless): name, symbol, decimals, on-chain USD price, FDV, market cap, total reserve in USD, 24h volume, total + normalized supply, image, and CoinGecko id. Distinct from crypto.token-price (CoinGecko aggregate spot) — this is DEX-derived on-chain data for any token across 100+ networks.","url":"https://2s.io/api/crypto/token-info","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","required":["network","address"],"properties":{"address":{"type":"string","maxLength":120,"minLength":1,"description":"Token contract address."},"network":{"type":"string","maxLength":40,"minLength":1,"description":"Network slug, e.g. eth, bsc, base, solana."}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0036","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.0036/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0036","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0036","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_X4RdlTWeVBAAlskEwduHg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0036","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns DEX-derived on-chain token metrics (price, FDV, market cap, volume, supply, etc.) for any token contract address across 100+ networks, powered by GeckoTerminal.","exampleAgentPrompt":"Can you pull the on-chain token info for contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum — I need the current DEX price, market cap, FDV, and 24h volume from GeckoTerminal?","exampleUseCases":null,"resultDescription":"Returns a JSON object containing the token's name, symbol, decimals, current on-chain USD price (DEX-derived), fully diluted valuation, market cap, total reserve in USD, 24-hour trading volume, total and normalized supply, token image URL, and CoinGecko ID — all sourced from GeckoTerminal DEX pool data.","failureModes":["Unknown contract address or network slug returns 404 or empty result","Newly deployed token with no DEX liquidity may return null price fields","Incorrect network slug (e.g. 'ethereum' instead of 'eth') causes lookup failure","Token exists but has no GeckoTerminal coverage returns partial or empty data","Rate limiting or upstream GeckoTerminal outage returns 5xx error"],"whenToPreferThis":"Prefer this endpoint when you need DEX-derived, on-chain token data by contract address — especially for tokens that may not appear in CoinGecko aggregate spot pricing (crypto.token-price). Use this when you need reserve/liquidity data, normalized supply, or need to support 100+ blockchain networks including newer L2s. Ideal for DeFi analytics, new token research, or when you have a contract address but not a CoinGecko slug.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:09:53.170Z","isFirstParty":false}