{"uid":"cap_DfR30qbCb-WdV2x1_dQzv","slug":"blackforge-crypto-market-data-series-d5012381","name":"BlackForge Crypto Market Data Series","description":"BlackForge crypto market data from the major spot exchanges: every column, 1-minute to daily buckets, 90-day lookback. Covers 100 billable rows; finer buckets and premium columns count as more than one row each.","url":"https://api.blackforge.so/v1/series?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"],"type":"string"},"queryParams":{"type":"object","required":["exchange","symbol","metric","from","to","interval"],"properties":{"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:\\d{2})$","description":"End of the range, ISO 8601."},"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:\\d{2})$","description":"Start of the range, ISO 8601."},"metric":{"type":"string","description":"One metric key from GET /v1/catalog."},"symbol":{"type":"string","description":"Pair symbol, base then quote with no separator, such as BTCUSDT."},"exchange":{"enum":["binance","bitget","bybit","coinbase","gate","kraken","kucoin","mexc","okx"],"type":"string","description":"Spot exchange the pair trades on."},"interval":{"enum":["1m","5m","1h","1d"],"type":"string","description":"Bucket size of each point."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"metric":"downDepth5","points":[{"ts":1793145600000,"value":47120334.1,"quality":0,"qualityAll":0},{"ts":1793149200000,"value":48211034.2,"quality":0,"qualityAll":0},{"ts":1793152800000,"value":46988120.7,"quality":0,"qualityAll":0}],"symbol":"BTCUSDT","exchange":"binance"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.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_0xHtJb5bKjAyo-uLAHmj-","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":"Fetches time-series crypto market data (OHLCV and advanced metrics) for a given exchange, symbol, interval, and date range with up to 90-day lookback.","exampleAgentPrompt":"Pull the downDepth5 metric for BTCUSDT on Binance at 1-hour intervals from 2024-01-01T00:00Z to 2024-03-31T23:59Z so I can analyze liquidity depth trends over Q1.","exampleUseCases":[{"title":"Algorithmic trading signal research","prompt":"Get me 5-minute interval close price data for ETHUSDT on Bybit from 2024-06-01T00:00Z to 2024-06-30T23:59Z — I'm backtesting a momentum strategy."},{"title":"Cross-exchange liquidity comparison","prompt":"Fetch the downDepth5 metric for BTCUSDT on Binance and on OKX at daily intervals for the last 30 days so I can compare order book depth across exchanges."},{"title":"Real-time market monitoring dashboard","prompt":"Give me the last 24 hours of 1-minute volume data for SOLUSDT on Coinbase — from 2024-09-10T00:00Z to 2024-09-10T23:59Z — so I can spot any unusual spikes."}],"resultDescription":"Returns a JSON object containing the exchange name, symbol, metric name, and an array of time-series data points. Each point includes a Unix millisecond timestamp, a numeric metric value, and two quality flags (quality and qualityAll) indicating data reliability.","failureModes":["Missing or invalid required query parameters (exchange, symbol, metric, from, to, interval) returns a 400 error","Requested date range exceeds 90-day lookback limit","Symbol not available on the specified exchange","Metric key not found in catalog (must be validated via GET /v1/catalog first)","Insufficient payment or x402 payment failure returns 402","Requesting very fine intervals (e.g. 1m) over a wide range may produce more than 100 rows, increasing billable cost","Malformed ISO 8601 datetime strings in from/to parameters"],"whenToPreferThis":"Choose this endpoint when you need structured, time-bucketed crypto market metrics (including advanced columns beyond simple OHLCV) from major spot exchanges with quality flags. It is best suited for backtesting, quant research, liquidity analysis, and dashboard building where a 90-day lookback and multi-exchange coverage are sufficient. Prefer it over generic data aggregators when you need per-metric granularity with data quality indicators and a pay-per-use model via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:30:29.824Z","isFirstParty":false,"canonicalSlug":"blackforge-crypto-market-data-series-d5012381"}