{"uid":"cap_X6zd4R3l2tLxxrB-vVmVi","slug":"x402stock-crypto-pair-ohlcv-aggregates-7fd35dc3","name":"x402stock Crypto Pair OHLCV Aggregates","description":"Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.","url":"https://x402stock.xyz/api/v1/crypto/%7Bpair%7D/aggregates","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","$schema":"https://json-schema.org/draft/2020-12/schema","required":["multiplier","timespan","from","to","adjusted","sort","limit"],"properties":{"to":{"type":"string","default":"2026-09-16","minLength":1},"from":{"type":"string","default":"2025-09-16","minLength":1},"sort":{"enum":["asc","desc"],"type":"string","default":"asc"},"limit":{"type":"integer","default":5000,"maximum":50000,"exclusiveMinimum":0},"adjusted":{"type":"boolean","default":true},"timespan":{"enum":["minute","hour","day","week","month","quarter","year"],"type":"string","default":"day"},"multiplier":{"type":"integer","default":1,"maximum":50000,"exclusiveMinimum":0}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["ticker","data","source","as_of"],"properties":{"data":{"type":"object","required":["bars","count"],"properties":{"bars":{"type":"array","items":{"type":"object","required":["open","high","low","close","volume","vwap","trade_count","timestamp"],"properties":{"low":{"type":"number"},"high":{"type":"number"},"open":{"type":"number"},"vwap":{"anyOf":[{"type":"number"},{"type":"null"}]},"close":{"type":"number"},"volume":{"type":"number"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}]},"trade_count":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false}},"count":{"type":"number"},"adjusted":{"type":"boolean"}},"additionalProperties":false},"as_of":{"type":"string"},"source":{"type":"string","const":"x402stock"},"ticker":{"type":"string"},"feedback":{"type":"object","required":["endpoint","method","free","note"],"properties":{"free":{"type":"boolean"},"note":{"type":"string"},"method":{"type":"string","const":"POST"},"endpoint":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"data":{"bars":[{"low":192.5,"high":196,"open":193,"vwap":194.8,"close":195.12,"volume":50000000,"timestamp":"2026-05-28T04:00:00.000Z","trade_count":450000}],"count":1,"adjusted":true},"as_of":"2026-05-29T20:00:00.000Z","source":"x402stock","ticker":"AAPL"}},"example":null,"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":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zcUGxW8aY_HmYB_XDJlR9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns historical OHLCV candlestick bar data for a cryptocurrency trading pair over a specified time range and timespan granularity, paid per request in USDC via x402.","exampleAgentPrompt":"Pull daily OHLCV bars for BTC-USD on x402stock from January 1 2025 to June 1 2025, adjusted, sorted ascending, limit 500 bars.","exampleUseCases":null,"resultDescription":"A JSON object containing the ticker symbol, an as_of timestamp, the data source label ('x402stock'), and a data object with a count and an array of candlestick bars — each bar includes open, high, low, close, volume, VWAP, trade count, and an ISO timestamp — plus an adjusted boolean flag.","failureModes":["Invalid or unsupported crypto pair symbol returns an error or empty bar array","Date range with no trading data returns bars array with count 0","Payment failure (insufficient USDC balance or x402 protocol error) blocks the request","Exceeding the maximum limit of 50000 bars returns a validation error","Invalid timespan enum value returns a schema validation error","from date later than to date returns an error or empty result"],"whenToPreferThis":"Use this endpoint when you need historical OHLCV candlestick data for a specific cryptocurrency pair and want pay-per-call access with no API key or account setup, paying $0.02 USDC per request via x402 on Base. Prefer this over subscription-based data providers when running AI agents that need on-demand crypto price history for backtesting, charting, or analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:30:01.654Z","isFirstParty":false}