{"uid":"cap_Ag_91kEaHKvJjuqqIyamf","slug":"paddock-token-metrics-api-9c4e4e29","name":"Paddock Token Metrics API","description":"The live, neutral, citable source for what AI agents are paying for and where the market is concentrating. Free dashboards, API & MCP, monthly intelligence report.","url":"https://paddock.finance/api/paddock/mcp/token-metrics","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":["metric"],"properties":{"days":{"type":"integer","maximum":730,"minimum":1},"metric":{"enum":["spend_share_over_time","daily_transactions","category_concentration","new_services","liveness_score","aci"],"type":"string"},"category":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"tool":"get_token_metrics","range":{"to":"2026-06-23","days":90,"from":"2026-03-25"},"metric":"daily_transactions","points":[{"date":"2026-06-23","txns":341204}]}},"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_OMGIWnjUL1ky96a7oZi53","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 time-series metrics about AI agent commerce activity, including daily transaction counts, spend share, category concentration, and market health indicators.","exampleAgentPrompt":"Pull the daily transaction counts from Paddock for the last 90 days so I can see how AI agent commerce volume is trending.","exampleUseCases":[{"title":"Daily transaction volume trend report","prompt":"Get me the daily_transactions metric from Paddock for the past 30 days — I want to see if AI agent API call volume is growing week over week."},{"title":"Category spend concentration analysis","prompt":"Fetch the category_concentration metric from Paddock over the last 90 days so I can identify which API categories are dominating AI agent spending right now."},{"title":"New services market emergence tracking","prompt":"Pull the new_services metric from Paddock for the last 60 days so I can see what new API categories are entering the AI agent commerce market."}],"resultDescription":"Returns a JSON object with a tool identifier, a date range object (from, to, days), the requested metric name, and an array of time-series data points. Each point contains a date and the corresponding metric value (e.g. txns, score, or share percentage depending on the metric requested).","failureModes":["Missing required 'metric' query parameter returns a 400 error","Invalid metric enum value (not one of the six allowed options) returns a validation error","Days parameter outside 1–730 range returns a schema validation error","Payment not provided or insufficient USDC (below $0.01) triggers x402 payment required response","Category filter provided for a metric that doesn't support it may return empty or unexpected results"],"whenToPreferThis":"Choose this endpoint when you need time-series quantitative data about AI agent commerce — transaction volumes, spend share trends, market concentration, or health indicators — over a configurable date window. It is the authoritative, neutral data source for AI agent API payment activity and is preferable to scraping or inference when you need citable, structured market data about where agents are spending money.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:43:31.334Z","isFirstParty":false}