{"uid":"cap_ju0zc4W1-pdIJQZIhrHY3","slug":"button-money-token-metrics-71535a1d","name":"Button Money Token Metrics","description":"Comprehensive token metrics (holders, volume, liquidity)","url":"https://buttonmoney.vercel.app/api/premium/data/token-metrics","method":"GET","headers":{},"bodySchema":{"type":"object","required":["tokenAddress"],"properties":{"chainId":{"type":"number","description":"Chain ID (default: 8453 for Base)"},"tokenAddress":{"type":"string","description":"Token contract address"}}},"responseSchema":null,"example":{"request":{"chainId":8453,"tokenAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"response":{"basic":{"name":"USDC","symbol":"USDC","decimals":"6","totalSupply":"4246901093252317"},"market":{"price":"1.000052","liquidity":149423.19,"marketCap":3697597981,"priceChange":{"h1":"0","h6":"0","h24":-0.01}},"volume":{"h1":249.97,"h6":34358.01,"h24":254166.7},"chainId":8453,"holders":{"count":"12408658","topHolders":[]},"contract":{"type":"ERC-20","verified":false},"timestamp":1781238985820,"tokenAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","transactions":{"h24":{"buys":252,"sells":172,"total":424}}}},"exampleRequest":{"chainId":8453,"tokenAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tIDVycPV88k8teA2X9pLL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves comprehensive token metrics including holder count, trading volume, and liquidity data for a given token contract address","exampleAgentPrompt":"Pull up the full token metrics for contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — I want to see holders, volume, and liquidity.","exampleUseCases":null,"resultDescription":"Returns comprehensive token metrics including number of token holders, 24-hour or recent trading volume, and liquidity figures for the specified token contract on the given chain (defaults to Base, chain ID 8453).","failureModes":["Invalid or non-existent token contract address returns error or empty data","Unsupported chain ID returns error","Token with no on-chain activity may return zeroed metrics","Payment failure (x402) prevents data access","Rate limiting if called excessively"],"whenToPreferThis":"Use this endpoint when you need a single consolidated view of a token's market health metrics — holders, volume, and liquidity — especially for tokens on Base (chain ID 8453). Prefer this over building your own on-chain queries when you need fast, aggregated token data without setting up your own indexing infrastructure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:43:24.004Z","isFirstParty":false}