Skip to main content
GET
/
api
/
v1
/
instruments
List instruments
curl --request GET \
  --url https://api.international.coinbase.com/api/v1/instruments
[
  {
    "instrument_id": 22653087021498350,
    "instrument_uuid": "97645486-8058-4d98-aa1e-5ab2685d09c8",
    "symbol": "BTC-USDC",
    "type": "PERP",
    "mode": "STANDARD",
    "base_asset_id": 2919822098049565,
    "base_asset_uuid": "592a8039-db3e-45ed-b752-ffd1983eead2",
    "base_asset_name": "BTC",
    "quote_asset_id": 45922259775510770,
    "quote_asset_uuid": "a96dc949-7650-4a70-8227-955366a22297",
    "quote_asset_name": "USDC",
    "base_increment": 0.000001,
    "quote_increment": 0.01,
    "price_band_percent": 0.02,
    "market_order_percent": 0.015,
    "qty_24hr": 4318.12,
    "notional_24hr": 86362400,
    "avg_daily_qty": 5741.531,
    "avg_daily_notional": 109430620,
    "previous_day_qty": 5741.531,
    "open_interest": 100,
    "position_limit_qty": "<string>",
    "position_limit_adq_pct": 0.03,
    "position_notional_limit": "57509393.1183",
    "open_interest_notional_limit": "299974395.974",
    "replacement_cost": 421.31,
    "base_imf": 0.1,
    "default_imf": 0.2,
    "min_notional_value": 10,
    "min_quantity": 0.0001,
    "funding_interval": 36000000000,
    "trading_state": "TRADING",
    "quote": {
      "best_bid_price": 20000.5,
      "best_bid_size": 3.541424,
      "best_ask_price": 20001.75,
      "best_ask_size": 2.8754,
      "trade_price": 20000.63,
      "trade_qty": 0.73,
      "index_price": 20001.45,
      "mark_price": 20000.63,
      "settlement_price": 20000.23,
      "limit_up": 21056.35,
      "limit_down": 19531.5,
      "predicted_funding": 0.1543,
      "timestamp": "2023-11-07T05:31:56Z"
    },
    "base_asset_multiplier": 1,
    "underlying_type": "SPOT",
    "rfq_maker_fee_rate": 0.01,
    "execution_exchange": "COINBASE_INTERNATIONAL_EXCHANGE"
  }
]
  • Java
  • .NET
  • Go
  • Python
  • TS/JS
  • CLI
InstrumentsService instrumentsService = IntxServiceFactory.createInstrumentsService(client);
ListInstrumentsRequest request = new ListInstrumentsRequest.Builder().build();
ListInstrumentsResponse response = instrumentsService.listInstruments(request);
For more information, please visit the INTX Java SDK.

Response

200 - application/json

Instrument list

​
instrument_id
string

A unique integer identifier to represent the instrument

Example:

22653087021498350

​
instrument_uuid
string<uuid>

A UUID to represent the instrument

Example:

"97645486-8058-4d98-aa1e-5ab2685d09c8"

​
symbol
string

A human readable representation of the instrument

Example:

"BTC-USDC"

​
type
enum<string>

The type of instrument

Available options:
SPOT,
PERP
Example:

"PERP"

​
mode
enum<string>

The mode of instrument

Available options:
STANDARD,
PRE_LAUNCH,
PRE_LAUNCH_CONVERTING
Example:

"STANDARD"

​
base_asset_id
string

The identifier of the base asset

Example:

2919822098049565

​
base_asset_uuid
string<uuid>

A UUID to represent the base asset

Example:

"592a8039-db3e-45ed-b752-ffd1983eead2"

​
base_asset_name
string

The name of the base asset

Example:

"BTC"

​
quote_asset_id
string

The identifier of the quote asset

Example:

45922259775510770

​
quote_asset_uuid
string<uuid>

A UUID to represent the quote asset

Example:

"a96dc949-7650-4a70-8227-955366a22297"

​
quote_asset_name
string

The name of the quote asset

Example:

"USDC"

​
base_increment
string

The minimum allowed quantity change of the base asset

Example:

0.000001

​
quote_increment
string

The minimum allowed price change of the quote asset

Example:

0.01

​
price_band_percent
number

The max percentage from BBO permitted for order placement

Example:

0.02

​
market_order_percent
number

The percentage from BBO used to price bound market orders

Example:

0.015

​
qty_24hr
string

The qty traded over the last 24hr period

Example:

4318.12

​
notional_24hr
string

The notional amount in USDC traded over the last 24hr period. For spot instruments which route orders to Coinbase exchange this field is not set, set to "", or 0

Example:

86362400

​
avg_daily_qty
string

The 30 day average daily traded qty updated daily

Example:

5741.531

​
avg_daily_notional
string

The 30 day average daily traded notional amount in USDC updated daily. For spot instruments which route orders to Coinbase exchange this field is not set, set to "", or 0

Example:

109430620

​
previous_day_qty
string

The traded qty in the previous day (It gets disseminated daily around 12am UTC.)

Example:

5741.531

​
open_interest
string

The total number of active positions held by traders

Example:

100

​
position_limit_qty
string

The max qty allowed for a position

​
position_limit_adq_pct
number

The max percentage of ADQ allowed for a position

Example:

0.03

​
position_notional_limit
string

The max notional value allowed for a position

Example:

"57509393.1183"

​
open_interest_notional_limit
string

The total notional value of active positions held by traders

Example:

"299974395.974"

​
replacement_cost
string

The replacement cost used in the margin calculations

Example:

421.31

​
base_imf
number

The margin requirement corresponding to maximum allowed leverage when trading on margin

Example:

0.1

​
default_imf
number

The margin requirement needed to exceed the high leverage position restrictions

Example:

0.2

​
min_notional_value
string

The smallest notional amount in USDC allowed to place an order

Example:

10

​
min_quantity
string

The smallest quantity of the base asset needed to place an order

Example:

0.0001

​
funding_interval
string

The amount of time in nanoseconds between funding intervals

Example:

36000000000

​
trading_state
enum<string>

An market level status affecting all trading within the market

Available options:
TRADING,
PAUSED,
HALT,
DELISTED,
EXTERNAL,
AUCTION_MODE,
CANCEL_ONLY,
POST_ONLY,
LIMIT_ONLY,
TRADING_DISABLED,
CANCEL_ONLY_ENFORCED_BY_COINBASE_INTERNATIONAL_EXCHANGE,
COINBASE_EXCHANGE_UNREACHABLE
Example:

"TRADING"

​
quote
object
​
base_asset_multiplier
string

The multiply factor to indicate the number of units in one contract

Example:

1

​
underlying_type
string

The type of the underlying asset. Value can be INDEX when underlying asset represents an index or SPOT when underlying asset is a spot.

Example:

"SPOT"

​
rfq_maker_fee_rate
string

The fee rate charged for RFQ quotes.

Example:

0.01

​
execution_exchange
string

The exchange which orders rest and match on. The value is COINBASE_INTERNATIONAL_EXCHANGE for all instruments except for spot instruments which route orders to Coinbase Exchange, in which case the value is COINBASE_EXCHANGE

Example:

"COINBASE_INTERNATIONAL_EXCHANGE"