GET /api/v3/brokerage/best_bid_ask — Best Bid and Ask

Retrieve the current top-of-book bid and ask prices for one or more Coinbase Advanced Trade products without pulling the full order book.

The Best Bid and Ask endpoint returns the current top-of-book (level 1) bid and ask prices for one or more trading pairs in a single request. For each product you request, you receive the best available bid price and size and the best available ask price and size at the moment of the call. This is useful for quickly assessing spread and liquidity before placing an order without fetching the full order book. This is a public endpoint — no authentication is required.

Endpoint

GET https://api.coinbase.com/api/v3/brokerage/best_bid_ask

Authentication

Not required. This is a public endpoint and can be called without an Authorization header.

Query Parameters

product_ids · string · required

Comma-separated list of product IDs for which you want the best bid and ask. For example: BTC-USD,ETH-USD,SOL-USD. You can query multiple products in a single request.

Response

pricebooks · array

Array of top-of-book entries, one per requested product.

Show Pricebook object fields

product_id · string

The trading pair identifier, e.g. "BTC-USD".

bids · array

Array containing the single best bid. Each element has:

• price (string) — Best bid price.
• size (string) — Quantity available at the best bid.

asks · array

Array containing the single best ask. Each element has:

• price (string) — Best ask price.
• size (string) — Quantity available at the best ask.

time · string

RFC 3339 timestamp of when this price book snapshot was taken.

Examples

cURL

curl -G https://api.coinbase.com/api/v3/brokerage/best_bid_ask \
  --data-urlencode "product_ids=BTC-USD,ETH-USD"

Response

{
  "pricebooks": [
    {
      "product_id": "BTC-USD",
      "bids": [
        {
          "price": "67840.00",
          "size": "0.12500000"
        }
      ],
      "asks": [
        {
          "price": "67845.23",
          "size": "0.08340000"
        }
      ],
      "time": "2024-05-01T18:45:02.341Z"
    },
    {
      "product_id": "ETH-USD",
      "bids": [
        {
          "price": "3519.88",
          "size": "2.45000000"
        }
      ],
      "asks": [
        {
          "price": "3521.10",
          "size": "1.82000000"
        }
      ],
      "time": "2024-05-01T18:45:02.341Z"
    }
  ]
}