{"uid":"cap_FQL57zFqpfIdbuPEx9jn1","slug":"hermes-token-report-7f6ea676","name":"Hermes Token Report","description":"Pay-per-call on-chain data for agents. USDC on Base over x402 (HTTP 402).","url":"https://x402-agent.majighufron.workers.dev/api/token-report?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","HEAD","DELETE"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","required":["token"],"properties":{"pool":{"type":"string","description":"Optional address holding the token, for a depth reading."},"chain":{"enum":["base","base-sepolia","robinhood"],"type":"string","description":"Chain to read."},"token":{"type":"string","description":"ERC-20 contract address (0x + 40 hex)."},"blocks":{"type":"integer","maximum":5000,"minimum":1,"description":"How many recent blocks to scan for transfers."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"chain":"base","token":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","supply":"4,000,000,000","activity":{"volume":"1,200,000","transfers":120,"windowBlocks":300,"uniqueSenders":80,"largestTransfer":"250,000","uniqueReceivers":90},"metadata":{"name":"USD Coin","symbol":"USDC","decimals":6}}},"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_maatIKlYDjpRIFicALjPg","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":"Returns on-chain ERC-20 token metadata, supply, and recent transfer activity for a given token address on Base or related chains.","exampleAgentPrompt":"Pull a token report for the USDC contract 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 on Base, scanning the last 300 blocks, and show me supply, recent transfer volume, and unique senders/receivers.","exampleUseCases":[{"title":"DeFi due diligence on new token","prompt":"I'm looking at a new token at 0xabc123...def456 on Base — can you pull its on-chain report for the last 500 blocks so I can see supply, how many wallets are trading it, and what the largest single transfer has been?"},{"title":"Monitor token activity before listing","prompt":"Before we list this ERC-20 at 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 on Base, can you check its recent transfer activity over the last 1000 blocks — I want to see volume, unique senders, and the biggest transfer so we can gauge liquidity?"},{"title":"Automated agent token health check","prompt":"Every hour, check the token at 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA on Base for the last 100 blocks and alert me if transfer volume spikes above 500,000 or the number of unique senders doubles."}],"resultDescription":"A JSON object confirming success, the chain queried, the token address, total supply formatted with commas, token metadata (name, symbol, decimals), and a recent activity summary including volume, transfer count, unique senders, unique receivers, largest transfer, and the block window scanned.","failureModes":["Invalid or malformed token address returns an error","Unsupported chain value outside base/base-sepolia/robinhood causes rejection","Blocks parameter exceeding 5000 is rejected by schema validation","Payment failure via x402 (402 status) if USDC balance is insufficient","Token contract not found on specified chain returns empty or error response","Rate limiting or worker downtime returns 5xx errors"],"whenToPreferThis":"Choose this endpoint when you need real-time, pay-per-call on-chain ERC-20 analytics on Base or related chains without a subscription — ideal for agents that need occasional token health checks, DeFi due diligence, or activity monitoring without committing to a monthly data plan. Prefer this over free explorers when you need structured JSON output ready for agent pipelines, or when you need pool-depth data alongside transfer activity.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T06:33:44.022Z","isFirstParty":false,"canonicalSlug":"hermes-token-report-7f6ea676"}