Binance API: Get order book
Gets the current bid and ask price levels for a Binance spot pair from a coin name or symbol, with the spread.
Unofficial. Not affiliated with or endorsed by Binance.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Coin, required
coin The coin name or symbol, for example Bitcoin or BTC.
Bitcoin
- Depth optional
depth Price levels to show per side, for example 20.
20 (default)
Whole number. One of
5,10,20,50,100.- Currency optional
currency Currency symbol used to price the coin, for example USDT or BTC.
USDT (default)
Input as JSON
{ "coin": "Bitcoin"}Output
{ "asks": [ { "price": 81783.32, "quantity": 5.64704 }, { "price": 81783.33, "quantity": 0.00924 }, { "price": 81783.6, "quantity": 0.00014 } ], "bids": [ { "price": 81783.31, "quantity": 1.52302 }, { "price": 81783.3, "quantity": 0.00049 }, { "price": 81782.08, "quantity": 0.00014 } ], "pair": "BTC/USDT" , "time": "2026-10-23T09:02:51.325346+00:00", "best_ask": 81783.32, "best_bid": 81783.31, "page_link": "https://www.binance.com/en/trade/BTC_USDT" , "spread_percent": 0.000012227432942770784, "spread_absolute": 0.01, "order_book_update_id": 101815274054}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"binance.com/get_order_book","input":{"coin":"Bitcoin"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "binance.com/get_order_book" , "input": { "coin": "Bitcoin" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "binance.com/get_order_book" , "input": { "coin": "Bitcoin" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run binance.com/get_order_book# with {"coin":"Bitcoin"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "coin" ], "properties": { "coin": { "type": "string", "description": "The coin name or symbol, for example Bitcoin or BTC." }, "depth": { "enum": [ 5, 10, 20, 50, 100 ], "type": "integer", "default": 20, "description": "Price levels to show per side, for example 20." }, "currency": { "type": "string", "default": "USDT", "description": "Currency symbol used to price the coin, for example USDT or BTC." } }}Output schema
{ "type": "object", "required": [ "pair", "best_bid", "best_ask", "spread_absolute", "spread_percent", "time", "bids", "asks", "page_link", "order_book_update_id" ], "properties": { "asks": { "type": "array", "items": { "type": "object", "required": [ "price", "quantity" ], "properties": { "price": { "type": "number", "description": "Price per coin in the quote currency." }, "quantity": { "type": "number", "description": "Amount of the coin available at this price." } }, "additionalProperties": false }, "description": "Sell levels, lowest price first." }, "bids": { "type": "array", "items": { "type": "object", "required": [ "price", "quantity" ], "properties": { "price": { "type": "number", "description": "Price per coin in the quote currency." }, "quantity": { "type": "number", "description": "Amount of the coin available at this price." } }, "additionalProperties": false }, "description": "Buy levels, highest price first." }, "pair": { "type": "string", "description": "Base coin and quote currency, for example BTC/USDT." }, "time": { "type": "string", "format": "date-time", "description": "Approximate snapshot receipt time in UTC." }, "best_ask": { "type": "number", "description": "Lowest sell price in the quote currency." }, "best_bid": { "type": "number", "description": "Highest buy price in the quote currency." }, "page_link": { "type": "string", "format": "uri", "description": "Binance trading page for the pair." }, "spread_percent": { "type": "number", "description": "Spread as a percent of the midpoint between the best bid and best ask." }, "spread_absolute": { "type": "number", "description": "Best ask minus best bid in the quote currency." }, "order_book_update_id": { "type": "integer", "description": "Binance order book last update ID." } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
binance.com/get_order_book- Returns
- pair, best bid and ask, spread, bid and ask levels, snapshot 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_order_book with the inputs above.
Ask your agent
- Show me the current bid and ask levels for Ethereum against USDT, top 10 per side, with the spread
- What's the order book look like for SOL paired with USDT right now? I want the best bid, best ask and spread.
- Pull up 50 price levels per side for Dogecoin priced in USDT, and tell me the snapshot time
- I need the live buy and sell depth for BTC on binance.com, quoted in BTC-denominated pairs if available, 5 levels each side
- Can you check the spread and top 20 bids and asks for Litecoin priced in USDT?
See more
All Binance methodsGets 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_priceGets 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/get_price_historyGets 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_priceGets a cryptocurrency's price, 24-hour change, market statistics, popularity, tradability, description and website from its public Coinbase price page.
coinbase.com/get_coin_overviewLooks up a cryptocurrency's current Coinbase spot, buy and sell prices in a chosen currency.
coinbase.com/get_coin_priceGets a cryptocurrency's price, changes, supply, market cap, volume and all-time high in a chosen currency. If a name or symbol is shared, returns the coin with the largest market cap.
coinmarketcap.com/get_coin_priceGets 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_dateGets 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