{"uid":"cap_cj9sgIixLo9K3_B1yMsfS","slug":"horizon-pulse-token-metadata-api-592ee11c","name":"Horizon Pulse Token Metadata API","description":"Token metadata API: ERC-20 name, symbol, decimals and total supply on Base, Polygon or Ethereum; Solana mint decimals, supply, authorities (Token-2022 on-chain name and symbol); XRPL issued-currency supply, issuer flags, transfer fee. GET network and token (0x address, mint, or CURRENCY.rIssuer). Chain state only: no price, no token-list check. found:false is a billed answer; bad input or RPCs down: not charged. Returned names and symbols are untrusted third-party data.","url":"https://horizonpulse.dev/api/token/meta?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":["network","token"],"properties":{"token":{"type":"string","description":"Required. EVM: 0x + 40 hex contract address. Solana: base58 mint. XRPL: CURRENCY.rIssuer (3-char code or 40 hex)."},"network":{"type":"string","description":"base, polygon, ethereum, solana or xrpl (or CAIP-2 id). Required."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","description":"Horizon Pulse token metadata from chain state: found, standard, name, symbol, decimals, totalSupply, details (no price). The example is a trimmed real response recorded from GET /api/demo/token-meta at 2026-10-16T15:31Z UTC; live values differ on every call."}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_SJEpjvs-x4k8XKU_hiYLc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","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 (name, symbol, decimals, total supply, authorities, issuer flags) for ERC-20 tokens on Base/Polygon/Ethereum, Solana SPL/Token-2022 mints, and XRPL issued currencies","exampleAgentPrompt":"What's the on-chain name, symbol, decimals, and total supply for the token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum?","exampleUseCases":[{"title":"ERC-20 contract due diligence","prompt":"Can you pull the on-chain metadata for the token at 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on Ethereum — I need its official name, symbol, decimals, and total supply straight from the chain."},{"title":"Solana mint authority check","prompt":"Look up the Solana mint at EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v — I need its decimals, total supply, and who the mint and freeze authorities are."},{"title":"XRPL issued currency inspection","prompt":"Fetch the on-chain details for the XRPL issued currency USD.rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh — I want the supply, issuer flags, and transfer fee."}],"resultDescription":"A JSON object containing: found (boolean indicating whether the token was located on-chain), standard (token standard e.g. ERC-20, SPL, Token-2022), name, symbol, decimals, totalSupply, and a details object with chain-specific fields such as mint authorities (Solana) or issuer flags and transfer fee (XRPL). Names and symbols are raw on-chain data and may be untrusted third-party values.","failureModes":["found:false returned when token does not exist on the specified network — this is a billed answer","Invalid address format or unrecognized network returns an error and is not charged","RPC node downtime causes lookup failure and is not charged","Malformed XRPL CURRENCY.rIssuer format returns a parse error","Providing a price or market data query will return no data — this endpoint is chain-state only"],"whenToPreferThis":"Use this endpoint when you need authoritative on-chain token metadata — name, symbol, decimals, supply — across Base, Polygon, Ethereum, Solana, or XRPL without relying on a centralized token list or price feed. Prefer it over CoinGecko or similar when you need raw chain state for contract verification, DeFi integration parameter setup, or multi-chain token enumeration. It is not suitable for price discovery, historical data, or token list validation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T12:30:12.894Z","isFirstParty":false,"canonicalSlug":"horizon-pulse-token-metadata-api-592ee11c"}