Get Product

curl --request GET \
  --url https://api.coinbase.com/api/v3/brokerage/products/{product_id}

{
  "product_id": "BTC-USD",
  "price": "140.21",
  "price_percentage_change_24h": "9.43%",
  "volume_24h": "1908432",
  "volume_percentage_change_24h": "9.43%",
  "base_increment": "0.00000001",
  "quote_increment": "0.00000001",
  "quote_min_size": "0.00000001",
  "quote_max_size": "1000",
  "base_min_size": "0.00000001",
  "base_max_size": "1000",
  "base_name": "Bitcoin",
  "quote_name": "US Dollar",
  "watched": true,
  "is_disabled": false,
  "new": true,
  "status": "<string>",
  "cancel_only": true,
  "limit_only": true,
  "post_only": true,
  "trading_disabled": false,
  "auction_mode": true,
  "product_type": "<any>",
  "quote_currency_id": "USD",
  "base_currency_id": "BTC",
  "fcm_trading_session_details": {
    "is_session_open": true,
    "open_time": "<string>",
    "close_time": "<string>",
    "session_state": "<any>",
    "after_hours_order_entry_disabled": true,
    "closed_reason": "<any>",
    "maintenance": {
      "start_time": "<string>",
      "end_time": "<string>"
    }
  },
  "mid_market_price": "140.22",
  "alias": "BTC-USD",
  "alias_to": [
    "BTC-USDC"
  ],
  "base_display_symbol": "BTC",
  "quote_display_symbol": "USD",
  "view_only": true,
  "price_increment": "0.00000001",
  "display_name": "BTC PERP",
  "product_venue": "<any>",
  "approximate_quote_24h_volume": "1908432",
  "new_at": "2021-07-01T00:00:00.000Z",
  "future_product_details": {
    "venue": "<string>",
    "contract_code": "<string>",
    "contract_expiry": "<string>",
    "contract_size": "<string>",
    "contract_root_unit": "<string>",
    "group_description": "<string>",
    "contract_expiry_timezone": "<string>",
    "group_short_description": "<string>",
    "risk_managed_by": "<any>",
    "contract_expiry_type": "<any>",
    "perpetual_details": {
      "open_interest": "<string>",
      "funding_rate": "<string>",
      "funding_time": "<string>",
      "max_leverage": "<string>",
      "base_asset_uuid": "<string>",
      "underlying_type": "<string>"
    },
    "contract_display_name": "<string>",
    "time_to_expiry_ms": "<string>",
    "non_crypto": true,
    "contract_expiry_name": "<string>",
    "twenty_four_by_seven": true
  }
}

GET

api

brokerage

products

{product_id}

Get Product

curl --request GET \
  --url https://api.coinbase.com/api/v3/brokerage/products/{product_id}

{
  "product_id": "BTC-USD",
  "price": "140.21",
  "price_percentage_change_24h": "9.43%",
  "volume_24h": "1908432",
  "volume_percentage_change_24h": "9.43%",
  "base_increment": "0.00000001",
  "quote_increment": "0.00000001",
  "quote_min_size": "0.00000001",
  "quote_max_size": "1000",
  "base_min_size": "0.00000001",
  "base_max_size": "1000",
  "base_name": "Bitcoin",
  "quote_name": "US Dollar",
  "watched": true,
  "is_disabled": false,
  "new": true,
  "status": "<string>",
  "cancel_only": true,
  "limit_only": true,
  "post_only": true,
  "trading_disabled": false,
  "auction_mode": true,
  "product_type": "<any>",
  "quote_currency_id": "USD",
  "base_currency_id": "BTC",
  "fcm_trading_session_details": {
    "is_session_open": true,
    "open_time": "<string>",
    "close_time": "<string>",
    "session_state": "<any>",
    "after_hours_order_entry_disabled": true,
    "closed_reason": "<any>",
    "maintenance": {
      "start_time": "<string>",
      "end_time": "<string>"
    }
  },
  "mid_market_price": "140.22",
  "alias": "BTC-USD",
  "alias_to": [
    "BTC-USDC"
  ],
  "base_display_symbol": "BTC",
  "quote_display_symbol": "USD",
  "view_only": true,
  "price_increment": "0.00000001",
  "display_name": "BTC PERP",
  "product_venue": "<any>",
  "approximate_quote_24h_volume": "1908432",
  "new_at": "2021-07-01T00:00:00.000Z",
  "future_product_details": {
    "venue": "<string>",
    "contract_code": "<string>",
    "contract_expiry": "<string>",
    "contract_size": "<string>",
    "contract_root_unit": "<string>",
    "group_description": "<string>",
    "contract_expiry_timezone": "<string>",
    "group_short_description": "<string>",
    "risk_managed_by": "<any>",
    "contract_expiry_type": "<any>",
    "perpetual_details": {
      "open_interest": "<string>",
      "funding_rate": "<string>",
      "funding_time": "<string>",
      "max_leverage": "<string>",
      "base_asset_uuid": "<string>",
      "underlying_type": "<string>"
    },
    "contract_display_name": "<string>",
    "time_to_expiry_ms": "<string>",
    "non_crypto": true,
    "contract_expiry_name": "<string>",
    "twenty_four_by_seven": true
  }
}

Path Parameters

product_id

string

required

The trading pair (e.g. 'BTC-USD').

Query Parameters

get_tradability_status

boolean

Whether or not to populate view_only with the tradability status of the product. This is only enabled for SPOT products.

Response

A successful response.

product_id

string

required

The trading pair (e.g. 'BTC-USD').

Example:

"BTC-USD"

price

string

required

The current price for the product, in quote currency.

Example:

"140.21"

price_percentage_change_24h

string

required

The amount the price of the product has changed, in percent, in the last 24 hours.

Example:

"9.43%"

volume_24h

string

required

The trading volume for the product in the last 24 hours.

Example:

"1908432"

volume_percentage_change_24h

string

required

The amount the volume of the product has changed, in percent, in the last 24 hours.

Example:

"9.43%"

base_increment

string

required

Minimum amount base value can be increased or decreased at once.

Example:

"0.00000001"

quote_increment

string

required

Minimum amount quote value can be increased or decreased at once.

Example:

"0.00000001"

quote_min_size

string

required

Minimum size that can be represented of quote currency.

Example:

"0.00000001"

quote_max_size

string

required

Maximum size that can be represented of quote currency.

Example:

"1000"

base_min_size

string

required

Minimum size that can be represented of base currency.

Example:

"0.00000001"

base_max_size

string

required

Maximum size that can be represented of base currency.

Example:

"1000"

base_name

string

required

Name of the base currency.

Example:

"Bitcoin"

quote_name

string

required

Name of the quote currency.

Example:

"US Dollar"

watched

boolean

required

Whether or not the product is on the user's watchlist.

Example:

true

is_disabled

boolean

required

Whether or not the product is disabled for trading.

Example:

false

new

boolean

required

Whether or not the product is 'new'.

Example:

true

status

string

required

Status of the product.

cancel_only

boolean

required

Whether or not orders of the product can only be cancelled, not placed or edited.

Example:

true

limit_only

boolean

required

Whether or not orders of the product can only be limit orders, not market orders.

Example:

true

post_only

boolean

required

Whether or not orders of the product can only be posted, not cancelled.

Example:

true

trading_disabled

boolean

required

Whether or not the product is disabled for trading for all market participants.

Example:

false

auction_mode

boolean

required

Whether or not the product is in auction mode.

Example:

true

base_display_symbol

string

required

Symbol of the base display currency.

Example:

"BTC"

quote_display_symbol

string

required

Symbol of the quote display currency.

Example:

"USD"

product_type

any

quote_currency_id

string

Symbol of the quote currency.

Example:

"USD"

base_currency_id

string

Symbol of the base currency.

Example:

"BTC"

fcm_trading_session_details

object

Show child attributes

mid_market_price

string

The current midpoint of the bid-ask spread, in quote currency.

Example:

"140.22"

alias

string

Product id for the corresponding unified book.

Example:

"BTC-USD"

alias_to

string[]

Product ids that this product serves as an alias for.

Example:

["BTC-USDC"]

view_only

boolean

Reflects whether an FCM product has expired. For SPOT, set get_tradability_status to get a return value here. Defaulted to false for all other product types.

Example:

true

price_increment

string

Minimum amount price can be increased or decreased at once.

Example:

"0.00000001"

display_name

string

Display name for the product e.g. BTC-PERP-INTX => BTC PERP

Example:

"BTC PERP"

product_venue

any

approximate_quote_24h_volume

string

The approximate trading volume for the product in the last 24 hours based on the current quote.

Example:

"1908432"

new_at

string<RFC3339 Timestamp>

The timestamp when the product was listed. This is only populated if product has new tag.

Example:

"2021-07-01T00:00:00.000Z"

future_product_details

object

Show child attributes

Get Market Trades

Get Product Book

REST API

Path Parameters

Query Parameters

Response