# Binance API: Get price history > Gets Binance spot price candles for a coin and quote currency, newest by default or within a UTC date range, up to 1,000 candles. Unofficial. Not affiliated with or endorsed by Binance. - Page: https://fous.com/methods/binance.com/get-price-history - Method: `binance.com/get_price_history`, version 1 - Website: binance.com - Returns: pair, interval, candles with open/high/low/close, volumes, trade count, open time - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `coin` | string | yes | `"BTC"` | Coin name or symbol, for example Ethereum or ETH. | | `currency` | string | no | `"USDT"` | Quote currency symbol, for example USDT or BTC. Default "USDT". | | `end_date` | string | no | `"2024-01-03"` | Last day of history, UTC (inclusive), for example 2024-01-07. | | `interval` | string | no | `"1_day"` | Candle period, for example 1_day. One of "1_minute", "5_minutes", "15_minutes", "1_hour", "4_hours", "1_day", "1_week". Default "1_hour". | | `start_date` | string | no | `"2024-01-01"` | First day of history, UTC (inclusive), for example 2024-01-01. | | `max_results` | integer | no | `5` | Maximum candles to return, for example 100. Default 100. | ## Output From a run on Oct 23, 2026. Its input: ```json { "coin": "BTC", "currency": "USDT", "end_date": "2024-01-03", "interval": "1_day", "start_date": "2024-01-01", "max_results": 5 } ``` Its output: ```json { "pair": "BTC/USDT", "candles": [ { "low": 42180.77, "high": 44184.1, "open": 42283.58, "close": 44179.55, "open_time": "2024-01-01T00:00:00.000+00:00", "page_link": "https://www.binance.com/en/trade/BTC_USDT", "volume_coin": 27174.29903, "volume_currency": 1169995682.0280013, "number_of_trades": 1114623, "open_time_epoch_ms": 1704067200000 }, { "low": 44148.34, "high": 45879.63, "open": 44179.55, "close": 44946.91, "open_time": "2024-01-02T00:00:00.000+00:00", "page_link": "https://www.binance.com/en/trade/BTC_USDT", "volume_coin": 65146.40661, "volume_currency": 2944331821.8230762, "number_of_trades": 2247532, "open_time_epoch_ms": 1704153600000 }, { "low": 40750, "high": 45500, "open": 44946.91, "close": 42845.23, "open_time": "2024-01-03T00:00:00.000+00:00", "page_link": "https://www.binance.com/en/trade/BTC_USDT", "volume_coin": 81194.55173, "volume_currency": 3507104563.744232, "number_of_trades": 2658041, "open_time_epoch_ms": 1704240000000 } ], "interval": "1_day" } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"binance.com/get_price_history","input":{"coin":"BTC","currency":"USDT","end_date":"2024-01-03","interval":"1_day","start_date":"2024-01-01","max_results":5}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Show me the last 50 hourly candles for Solana against USDT - I need daily BTC/USDT candles from 2023-06-01 through 2023-06-30 in UTC - Pull 4-hour price candles for Dogecoin priced in BTC for the past week - Get 15-minute open, high, low, close data for ETH paired with USDT on binance.com, max 200 candles - What were the weekly candles for Cardano in USDT between 2022-01-01 and 2023-12-31? ## Input schema ```json { "type": "object", "required": [ "coin" ], "properties": { "coin": { "type": "string", "description": "Coin name or symbol, for example Ethereum or ETH." }, "currency": { "type": "string", "default": "USDT", "description": "Quote currency symbol, for example USDT or BTC." }, "end_date": { "type": "string", "description": "Last day of history, UTC (inclusive), for example 2024-01-07." }, "interval": { "enum": [ "1_minute", "5_minutes", "15_minutes", "1_hour", "4_hours", "1_day", "1_week" ], "type": "string", "default": "1_hour", "description": "Candle period, for example 1_day." }, "start_date": { "type": "string", "description": "First day of history, UTC (inclusive), for example 2024-01-01." }, "max_results": { "type": "integer", "default": 100, "maximum": 1000, "minimum": 1, "description": "Maximum candles to return, for example 100." } } } ``` ## Output schema ```json { "type": "object", "required": [ "pair", "interval", "candles" ], "properties": { "pair": { "type": "string", "description": "Trading pair, for example ETH/USDT." }, "candles": { "type": "array", "items": { "type": "object", "required": [ "open_time", "open", "high", "low", "close", "volume_coin", "volume_currency", "number_of_trades", "open_time_epoch_ms", "page_link" ], "properties": { "low": { "type": "number", "description": "Lowest price in the quote currency." }, "high": { "type": "number", "description": "Highest price in the quote currency." }, "open": { "type": "number", "description": "Opening price in the quote currency." }, "close": { "type": "number", "description": "Closing price in the quote currency." }, "open_time": { "type": "string", "description": "Candle opening time in UTC, ISO 8601." }, "page_link": { "type": "string", "description": "Binance trading page for this pair." }, "volume_coin": { "type": "number", "description": "Traded volume in the coin." }, "volume_currency": { "type": "number", "description": "Traded volume in the quote currency." }, "number_of_trades": { "type": "integer", "description": "Number of trades in this candle." }, "open_time_epoch_ms": { "type": "integer", "description": "Candle opening time, epoch milliseconds." } } } }, "interval": { "type": "string", "description": "Requested candle period." } } } ``` ## See more - [Binance API: Get coin price](https://fous.com/methods/binance.com/get-coin-price.md): Gets a Binance spot pair's latest price and rolling 24-hour trading statistics from a coin name or symbol. Only currently trading pairs are available. - [Binance API: Get order book](https://fous.com/methods/binance.com/get-order-book.md): Gets the current bid and ask price levels for a Binance spot pair from a coin name or symbol, with the spread. - [CoinGecko API: Get coin price history](https://fous.com/methods/coingecko.com/get-coin-price-history.md): Gets a coin's daily prices and price change over the last 7, 30, 90 or 365 days, with UTC dates. Today's price may change. - [Kraken API: Get coin price](https://fous.com/methods/kraken.com/get-coin-price.md): Gets a coin's current Kraken price, bid and ask, and 24-hour trading statistics in a chosen currency, with change since today's midnight UTC open. - [CoinGecko API: Get coin price on date](https://fous.com/methods/coingecko.com/get-coin-price-on-date.md): Gets a coin's price, market cap and 24-hour volume at 00:00 UTC on a past date. Non-USD currencies are available only for the last 365 days. - [Coinbase API: Get coin overview](https://fous.com/methods/coinbase.com/get-coin-overview.md): Gets a cryptocurrency's price, 24-hour change, market statistics, popularity, tradability, description and website from its public Coinbase price page. - [Coinbase API: Get coin price](https://fous.com/methods/coinbase.com/get-coin-price.md): Looks up a cryptocurrency's current Coinbase spot, buy and sell prices in a chosen currency. - [Yahoo API: Get price history](https://fous.com/methods/finance.yahoo.com/get-price-history.md): Returns Yahoo Finance daily, weekly or monthly price history and total adjusted-close return for a stock, fund, index or cryptocurrency. - [All Binance methods](https://fous.com/methods/binance.com.md)