{"uid":"cap_wRM8KoOul-3dBAXWONGHf","slug":"mangrove-market-data-segment-914ecbb0","name":"Mangrove Market Data Segment","description":"Developer references for Mangrove Agent, API contracts, MCP and AI integrations.","url":"https://api.mangrovedeveloper.ai/api/v1/market-data/segment?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"},"queryParams":{"type":"object","properties":{"asset":{"type":"string","description":"Asset symbol, e.g. BTC or ETH."},"end_date":{"type":"string","description":"ISO end of the window."},"provider":{"type":"string","description":"Optional upstream override; omitted uses the existing server default."},"start_date":{"type":"string","description":"ISO start of the window, e.g. 2026-01-01."},"candle_size":{"type":"string","default":"1d","description":"Duration of one candle, e.g. 1h or 1d."},"quote_token":{"type":"string","description":"Quote currency of the requested market."},"window_file":{"type":"string","description":"A catalog window's file name, classified as it stands. Supply this or the asset with both dates, not both."},"market_data_venue":{"type":"string","description":"Exact venue of the requested market."}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.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_VI6OMzZz2yAT4LPv5z9JY","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":"Fetches historical OHLCV candlestick market data for a specified asset, date window, and trading venue","exampleAgentPrompt":"Can you pull the daily candlestick data for BTC quoted in USDC on Coinbase from 2025-01-01 to 2025-03-31?","exampleUseCases":[{"title":"Backtest trading strategy on BTC","prompt":"Get me the hourly candle data for BTC/USDC on Binance from 2024-06-01 to 2024-12-31 so I can run a backtest on my moving average strategy."},{"title":"Analyze ETH price trend last quarter","prompt":"Pull the daily OHLCV data for ETH quoted in USDT from 2025-01-01 to 2025-03-31 — I want to see how it trended over the last quarter."},{"title":"Compare asset performance across venues","prompt":"Fetch 1-day candle data for SOL quoted in USDC on Kraken for the whole of January 2025 — I'm comparing performance across different exchanges."}],"resultDescription":"Returns historical candlestick (OHLCV) market data for the requested asset, date window, candle size, and trading venue. Each record typically includes open, high, low, close, and volume values for the specified interval, segmented according to the requested time range.","failureModes":["Missing required asset or date window returns a validation error","Specifying both window_file and asset+dates simultaneously may result in a conflict error","Invalid candle_size format (e.g. unsupported intervals) returns a bad request error","Unknown asset symbol or quote token returns a not-found or empty result","Unsupported market_data_venue may return an error or fall back to server default","Request outside available historical data range returns empty or partial results","Payment failure (insufficient USDC) blocks the request with a 402 response"],"whenToPreferThis":"Use this endpoint when you need historical OHLCV candlestick data for a specific asset and date range, especially within the Mangrove Agent ecosystem. Prefer it when you need venue-specific data, flexible candle sizes (hourly, daily), or want to integrate market history into an AI agent workflow that uses MCP or x402 micropayment rails.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-04T06:35:27.652Z","isFirstParty":false,"canonicalSlug":"mangrove-market-data-segment-914ecbb0"}