{"uid":"cap_KIvjtvIocuom1FNyHa-wD","slug":"onchain-query-api-erc-20-token-profile-d676076f","name":"Onchain Query API – ERC-20 Token Profile","description":"ERC-20 token profile on any major EVM chain: on-chain metadata (name, symbol, decimals, total supply) read straight from the contract, joined with live DEX market data (USD price, liquidity, 24h volume, 24h change, and the top trading pair with its DEX). Use it to price a token, check liquidity depth before a swap, or resolve an unknown contract address into a real token.","url":"https://chain.cyberwarex.com/token","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"chain":{"enum":["base","ethereum","arbitrum","optimism","polygon"],"type":"string","default":"base","description":"EVM chain to query."},"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"ERC-20 token contract address."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"name":{"type":"string"},"chain":{"type":"string"},"market":{"type":"object","description":"Live DEX market data, or {note} when no DEX pair exists."},"symbol":{"type":"string"},"address":{"type":"string"},"decimals":{"type":"integer"},"total_supply":{"type":["number","null"]},"total_supply_raw":{"type":["string","null"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oBat95nGKy-G2x-GSG6bN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns metadata and live DEX market data for an ERC-20 token contract on a specified EVM chain, including name, symbol, decimals, total supply, and spot pricing.","exampleAgentPrompt":"Pull the full token profile for the USDC contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum — I want the name, symbol, decimals, total supply, and any live DEX market data.","exampleUseCases":[{"title":"DeFi bot token metadata enrichment","prompt":"I need the full profile for the token at 0x4200000000000000000000000000000000000006 on Base — give me its name, symbol, decimals, and current DEX price if available."},{"title":"Portfolio tracker supply verification","prompt":"What is the total supply and number of decimals for the ERC-20 contract 0x912CE59144191C1204E64559FE8253a0e49E6548 on Arbitrum?"},{"title":"Token listing due diligence","prompt":"Before we list this token, can you grab the on-chain metadata for contract 0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619 on Polygon — name, symbol, supply, and any live market price data?"}],"resultDescription":"A JSON object containing the token's name, symbol, contract address, chain, decimals, total supply (human-readable and raw), and a market object with live DEX pricing data — or a note field if no DEX pair exists for the token.","failureModes":["Invalid contract address format (must match ^0x[a-fA-F0-9]{40}$) returns a validation error","Address is a valid Ethereum address but not an ERC-20 contract on the specified chain returns empty or error response","Unsupported chain value outside the enum returns a 400 error","Token has no DEX liquidity pair — market object returns a note instead of price data","Payment not provided or insufficient (x402 payment required at $0.004 USDC per call)"],"whenToPreferThis":"Choose this endpoint when you need ERC-20 token metadata and live DEX market data for a specific contract address on a major EVM chain without managing RPC infrastructure or node keys. Ideal for agents that need deterministic, structured JSON token profiles on-demand at low per-call cost. Prefer over raw RPC calls when you want normalized output including supply and spot price in a single response.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:36:59.150Z","isFirstParty":false}