{"uid":"cap_RCxEX3t0K_iaGtYUGOgF-","slug":"synapse-api-polygon-token-metadata-lookup-26754e5d","name":"Synapse API — Polygon Token Metadata Lookup","description":"High-speed API suite for AI processing, web scraping, and smart data utilities across 57+ blockchain networks. Pay-per-call via x402.","url":"https://synapse-api-brown.vercel.app/api/polygon/token/metadata","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"contractAddress":{"type":"string"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__mnU8ZYbOt6rPaytfsurb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches on-chain metadata for a given ERC-20 or NFT token contract on the Polygon network, returning details such as name, symbol, decimals, and supply.","exampleAgentPrompt":"Can you look up the token metadata for the Polygon contract at 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 — I need the name, symbol, and decimals.","exampleUseCases":[{"title":"Identify unknown Polygon token","prompt":"I just received some tokens at contract address 0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619 on Polygon — can you tell me what this token is called, its ticker symbol, and how many decimals it uses?"},{"title":"DeFi dashboard token enrichment","prompt":"I'm building a portfolio tracker and need the full metadata for the Polygon token contract 0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270 — give me the name, symbol, decimals, and total supply."},{"title":"Verify token contract details before swap","prompt":"Before I swap, can you confirm the name and symbol for this Polygon contract address 0x8f3Cf7ad23Cd3CaDbD9735AFf958023239c6A063 so I know I have the right token?"}],"resultDescription":"Returns structured on-chain metadata for the specified Polygon token contract, including the token's name, symbol, number of decimals, total supply, and potentially token standard (ERC-20, ERC-721, etc.).","failureModes":["Invalid or malformed contract address returns a validation error","Contract address exists on a different chain (not Polygon) returns not found or empty metadata","Unverified or proxy contracts may return incomplete metadata","Network congestion or RPC timeout may cause delayed or failed responses","Non-token contracts (plain wallets or non-standard contracts) may return null fields"],"whenToPreferThis":"Choose this endpoint when you need to resolve token metadata specifically on the Polygon (MATIC) network by contract address. It is ideal for enriching DeFi dashboards, validating token identities before transactions, or building token registries on Polygon. Prefer this over generic blockchain explorers when you need a pay-per-call, agent-friendly API with structured JSON output on the Polygon chain specifically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:57:33.373Z","isFirstParty":false}