# 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. - Page: https://fous.com/methods/binance.com/get-order-book - Method: `binance.com/get_order_book`, version 1 - Website: binance.com - Returns: pair, best bid and ask, spread, bid and ask levels, snapshot 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 | `"Bitcoin"` | The coin name or symbol, for example Bitcoin or BTC. | | `depth` | integer | no | | Price levels to show per side, for example 20. One of 5, 10, 20, 50, 100. Default 20. | | `currency` | string | no | | Currency symbol used to price the coin, for example USDT or BTC. Default "USDT". | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "coin": "Bitcoin" } ``` Its output: ```json { "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 } ``` ## 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_order_book","input":{"coin":"Bitcoin"}}' ``` 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 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? ## Input schema ```json { "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 ```json { "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 } ``` ## 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 price history](https://fous.com/methods/binance.com/get-price-history.md): 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. - [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. - [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. - [CoinMarketCap API: Get coin price](https://fous.com/methods/coinmarketcap.com/get-coin-price.md): Gets 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. - [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. - [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. - [All Binance methods](https://fous.com/methods/binance.com.md)