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,
    "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
  }
]
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

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

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

​
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
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