Skip to content

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.

binance.com (opens in a new tab)Version 1ReadNo sign-inVerified Nov 2, 2026

Unofficial. Not affiliated with or endorsed by Binance.

Inputs

Values from the run on Oct 23, 2026, shown under Output.

Coin, requiredcoin

Coin name or symbol, for example Ethereum or ETH.

BTC

Currency optionalcurrency

Quote currency symbol, for example USDT or BTC.

USDT

Default USDT.

End Date optionalend_date

Last day of history, UTC (inclusive), for example 2024-01-07.

2024-01-03

Interval optionalinterval

Candle period, for example 1_day.

1_day

One of 1_minute, 5_minutes, 15_minutes, 1_hour, 4_hours, 1_day, 1_week. Default 1_hour.

Start Date optionalstart_date

First day of history, UTC (inclusive), for example 2024-01-01.

2024-01-01

Max Results optionalmax_results

Maximum candles to return, for example 100.

5

Whole number from 1 to 1000. Default 100.

Output

From a run on Oct 23, 2026.
{  "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"}
Price
1 credit per completed run (1¢ with pay as you go); failed runs are free.
Method
binance.com/get_price_history
Returns
pair, interval, candles with open/high/low/close, volumes, trade count, open time

Use it from your agent

Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method binance.com/get_price_history with the inputs above.

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?
  • 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.com/get_coin_price
  • Gets the current bid and ask price levels for a Binance spot pair from a coin name or symbol, with the spread.

    binance.com/get_order_book
  • 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.

    coingecko.com/get_coin_price_history
  • 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.

    kraken.com/get_coin_price
  • 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.

    coingecko.com/get_coin_price_on_date
  • Gets a cryptocurrency's price, 24-hour change, market statistics, popularity, tradability, description and website from its public Coinbase price page.

    coinbase.com/get_coin_overview
  • Looks up a cryptocurrency's current Coinbase spot, buy and sell prices in a chosen currency.

    coinbase.com/get_coin_price
  • Returns Yahoo Finance daily, weekly or monthly price history and total adjusted-close return for a stock, fund, index or cryptocurrency.

    finance.yahoo.com/get_price_history