{"uid":"cap_bkNVAi0a1HtzGMHhUiMLe","slug":"agents-allium-so-e2c8cd89","name":"Allium Token Price Statistics","description":"Get token price statistics","url":"https://agents.allium.so/api/v1/developer/prices/stats","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","bodyType","body","method"],"properties":{"body":{"type":"object","required":["token_address","chain"],"properties":{"chain":{"type":"string","description":"Blockchain network (e.g. ethereum, solana, base)"},"token_address":{"type":"string","description":"Token contract address"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"items":[{"mint":"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2","chain":"ethereum","low_1h":2480,"high_1h":2520,"low_24h":2400,"decimals":18,"high_24h":2600,"timestamp":"2025-06-17T18:00:00Z","latest_price":2500.5,"percent_change_1h":0.8,"percent_change_24h":2.5}]}},"example":{"request":[{"chain":"ethereum","token_address":"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"}],"response":{"items":[{"mint":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2","chain":"ethereum","low_1h":1661.337712086134,"high_1h":1706.3718617701163,"low_24h":1606.902284345932,"decimals":18,"high_24h":2113.074042660399,"timestamp":"2026-06-13T04:25:47","latest_price":1664.9134779768635,"percent_change_1h":0.0008718209371615496,"percent_change_24h":-0.0056914110375737405}]}},"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MrIOhEFWLP-drp4y5Z9_7","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_F4F9dYwxcnWK2NSjnBl0-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns statistical aggregates (min, max, average, volatility, etc.) for token prices over a specified period","exampleAgentPrompt":"Can you pull the price statistics for WBTC on Ethereum over the past 30 days — I want to see the min, max, average, and any volatility measures Allium has?","exampleUseCases":null,"resultDescription":"Returns computed price statistics for the specified token(s) and time window, including aggregates such as minimum price, maximum price, mean price, price change percentage, and volatility metrics derived from onchain price data.","failureModes":["Invalid or unrecognized token identifier returns 400 error","Unsupported chain returns 400 or empty result","Time range outside available data coverage returns empty or partial stats","Missing required body parameters returns 422 validation error","Payment failure via x402 protocol returns 402 Payment Required","Rate limiting or quota exceeded returns 429"],"whenToPreferThis":"Use this endpoint when you need aggregated statistical summaries of token prices over a time window (e.g., volatility, average, min/max) rather than a single point-in-time price or a full price history series. Prefer this over the 'Get latest token prices' endpoint when historical statistical analysis is needed, and over raw SQL queries when you specifically need price statistics without writing custom SQL.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:37:20.372Z","isFirstParty":false}