INTX Changelog - Coinbase Developer Documentation

These release notes list changes to all Coinbase International Exchange products.

2026-Jun-11

Underlying Security Type

Introducing new underlying security type values for pre-IPO instruments, which may be sent in instrument definition messages across FIX Market Data APIs.

FIX API, Market Data

SecurityDefinition (35=d) & SecurityList (35=y)

The following new values may now be sent in UnderlyingSecurityType (Tag 310):

Tag	Name	Type	Required	Values
310	UnderlyingSecurityType	STRING	N	`PREIPO` = CONTRACT_BASED_ON_PREIPO_EQUITY

2026-Jun-03

Underlying Security Type

Introducing new underlying security type values for pre-IPO instruments, which may be sent in instrument definition messages across REST and WebSocket Market Data APIs.

REST API, WebSocket Feed

The following new values may now be sent in the underlying_type field:

Value	Description
PREIPO	Contract based on pre-IPO equity

The above field is sent in:

REST API’s List instruments endpoint
REST API’s Get instrument details endpoint
WebSocket Feed’s INSTRUMENTS Channel

2026-Apr-22

Underlying Security Type

Introducing new underlying security type values for commodity instruments, which may be sent in instrument definition messages across REST, WebSocket, and FIX Market Data APIs.

REST API, WebSocket Feed

The following new values may now be sent in the underlying_type field:

Value	Description
COMMOD	Contract based on commodity
COMMOD_INDEX	Contract based on commodity index
COMMOD_ETF	Contract based on commodity ETF

The above field is sent in:

REST API’s List instruments endpoint
REST API’s Get instrument details endpoint
WebSocket Feed’s INSTRUMENTS Channel

FIX API, Market Data

SecurityDefinition (35=d) & SecurityList (35=y)

The following new values may now be sent in UnderlyingSecurityType (Tag 310):

Tag	Name	Type	Required	Values
310	UnderlyingSecurityType	STRING	N	`COMMOD` = CONTRACT_BASED_ON_COMMODITY `COMMOD_INDEX` = CONTRACT_BASED_ON_COMMODITY_INDEX `COMMOD_ETF` = CONTRACT_BASED_ON_COMMODITY_ETF

2026-Mar-19

Underlying Security Type

Introducing new underlying security type values which may be sent in instrument definition messages across REST, WebSocket, and FIX Market Data APIs. WebSocket and FIX Market Data APIs will also begin publishing underlying_type and UnderlyingSecurityType (Tag 310).

REST API, WebSocket Feed

The following new values may now be sent in the underlying_type field:

Value	Description
EQUITY	Contract based on equity single stock
EQUITY_ETF	Contract based on equity ETF
EQUITY_INDEX	Contract based on equity custom basket or index

The above field is sent in:

REST API’s List instruments endpoint
REST API’s Get instrument details endpoint
WebSocket Feed’s INSTRUMENTS Channel

FIX API, Market Data

SecurityDefinition (35=d) & SecurityList (35=y)

The following new values may now be sent in UnderlyingSecurityType (Tag 310):

Tag	Name	Type	Required	Values
310	UnderlyingSecurityType	STRING	N	`EQUITY` = CONTRACT_BASED_ON_EQUITY_SINGLE_STOCK `EQUITY_ETF` = CONTRACT_BASED_ON_EQUITY_ETF `EQUITY_INDEX` = CONTRACT_BASED_ON_EQUITY_CUSTOM_BASKET_OR_INDEX

2026-FEB-19

FIX Market Data: `MarketDataIncrementalRefresh` `MDEntry`’s where `MDEntryType=BID|OFFER`: New `LastFragment` and `MDEntryTime` fields

Two new fields will be added to MarketDataIncrementalRefresh messages which contain MDEntry(s) (repeating group component whose count is published as NoMDEntries/268) whose MDEntryType/269 is BID/0 or ASK/1. This does not require clients to modify their FIX engine behavior as both fields merely add additional metadata without any change to the underlying data sent.

LastFragment/893
- BOOLEAN type. Not required. Either set to YES/Y or not populated. Set on MarketDataIncrementalRefresh itself rather than in MDEntry components.
- If set to YES/Y, the MDEntrys in the message are the final updates in a batch (please see the MDEntryType=BID|OFFER Batch Fragmentation sub-section below).
MDEntryTime/273
- UTCTIMESTAMP type. Not required. Only and always set on MDEntrys components where MDEntryType=BID|OFFER. Millisecond precision.
- Contains the time the order event which triggered the price level change occurred. This time is different from TransactTime/60, which contains a time equal or higher than the order event time.

`MDEntryType=BID|OFFER` Batch Fragmentation

MarketDataIncrementalRefresh messages containing these MDEntryTypes for L2 data (all price levels) batch price level updates for performance reasons, meaning multiple price level updates are queued together before they are sent together in a batch. To prevent any single MarketDataIncrementalRefresh from becoming to large, a batch may be sent in multiple MarketDataIncrementalRefreshs (“fragments”). Clients may queue (but not process) MDEntryType=BID|OFFERs for MarketDataIncrementalRefreshs without LastFragment populated. On receipt of a MarketDataIncrementalRefresh with LastFragment=Y, clients may then queue the included MDEntryType=BID|OFFERs and then process all queued MDEntryType=BID|OFFERs for the Symbol which all the included MDEntrys are set to. This permits clients to process batches altogether at once rather than individual updates.

2026-Jan-22

Position Transfer Metadata

We are adding a new position_price field to the Get transfers and Get transfer REST API endpoints to indicate the price at which a position transfer was made.

2025-DEC-19

Cursor-Based Pagination for Transfers

Added optional cursor-based pagination support to the Get Transfers endpoint. This provides stable, consistent results when paginating through transfers, preventing duplicate results that can occur with offset-based pagination when new transfers are inserted between requests. When to use cursor vs offset pagination:

Use cursor-based pagination to avoid duplicate results when new transfers are created between paginated requests (though slightly slower than offset pagination)
Use offset-based pagination for better performance when consistency across pages is not critical
REST API
- New optional query parameters for Get Transfers:
  - pagination_type: Specifies pagination method (OFFSET or CURSOR)
  - search_after_time: Timestamp for cursor-based pagination
  - search_after_idem: Idempotency key for cursor-based pagination
- New response fields in pagination object:
  - search_after_time: Echoes the timestamp used in the current request
  - search_after_idem: Echoes the idempotency key used in the current request

2025-NOV-20

Position Transfer Metadata

Adding position transfer metadata in the REST API Get transfers and Get transfer endpoints. We are adding new fields position_from_portfolio and position_to_portfolio to denote the portfolios sending and receiving the transferred position. A position transfer action generates two transfer events: one for the position_from_portfolio and one for the position_to_portfolio. Both events share the same position_transfer_reference_id, which can be used to link them together. The field instrument_id and instrument_symbol will show the transferred position instrument, and position_size and position_side will show the transferred position size and side. The following is an example transfer returned from the above REST endpoints with explanation on the fields.

# The realized USDC PnL incurred due to the position transfer.
# For `position_from_portfolio`, the value is always zero.
# For `position_to_portfolio`, the value may be non-zero if `position_to_portfolio` is holding an existing position with opposite direction to the transferred position.
{'amount': '0.0003',

# The currency of the above realized PnL. It will always be USDC.
 'asset': 'USDC',
 'created_at': '2025-11-13T19:07:50Z',

# `from_portfolio` and `to_portfolio` are about the movement of the realized USDC PnL between CB_FUND and either positionFromPortfolio or positionToPortfolio.
 'from_portfolio': {'id': '3hnh4nf8-1-0',
                    'name': 'example portfolio2',
                    'uuid': 'bc35741f-7876-4ae9-af67-c84076293a34'},
 'to_portfolio': {'name': 'CB_FUND'},

# The instrument id of the transferred position
 'instrument_id': '149264164756389888',

# The instrument symbol of the transferred position
 'instrument_symbol': 'ETH-PERP',

# The reference id of the two transfer events generated in a position transfer action
'position_transfer_reference_id': '114jeqhr-1-0',

# The portfolio that sends the position
 'position_from_portfolio': {'id': '3hkpy5fw-1-0',
                             'name': 'example portfolio',
                             'uuid': '01aa7aa8-73fa-787f-984b-45bef5e8d4ef'},

# The portfolio that receives the position
 'position_to_portfolio': {'id': '3hnh4nf8-1-0',
                           'name': 'example portfolio2',
                           'uuid': 'bc35741f-7876-4ae9-af67-c84076293a34'},

# The transferred position side
 'position_side': 'BUY',

# The transferred position size
 'position_size': '0.0001',
 'status': 'PROCESSED',
 'transfer_type': 'POSITION_TRANSFER',
 'transfer_uuid': '0a6d7eb3-d544-35bd-9c2b-9af98fa50d77',
 'updated_at': '2025-11-13T19:07:50Z'}

2025-NOV-18

Spot Order Routing to Coinbase Exchange: Addendum for REST API’s `List instruments`, `Get instrument details`, `Get quote per instrument` endpoints

The following only applies for spot instruments configured to route spot orders to Coinbase Exchange.

List instruments, Get instrument details

notional_24hr, avg_daily_notional, avg_30day_notional, quote → limit_up, and quote → limit_down will be temporarily set to 0. This value is a placeholder and does not represent actual data. These fields will be deprecated and no longer populated in a future release. The following field will be added for all instruments:

Property	Type	Description
execution_exchange	string	For spot instruments configured to route orders to Coinbase Exchange, this is set to `COINBASE_EXCHANGE`. For all other instruments, this is set to `COINBASE_INTERNATIONAL_EXCHANGE`

Get quote per instrument

limit_up, and limit_down will be temporarily set to 0. This value is a placeholder and does not represent actual data. These fields will be deprecated and no longer populated in a future release.

2025-NOV-13

Spot Order Routing to Coinbase Exchange

Introducing support to route spot orders to rest and match on equivalent Coinbase Exchange books. Unless otherwise noted, the following only applies for spot instruments configured to route orders to Coinbase Exchange, orders routed to Coinbase Exchange, or fills on orders routed to Coinbase Exchange. Where noted, “forwarded” properties indicate that Coinbase International Exchange will publish data from Coinbase Exchange. For example, in the REST API’s List Instruments endpoint, for spot instruments configured to route orders to Coinbase Exchange, the qty_24hr property is forwarded, meaning it will represent the 24 hour trading volume for the instrument on Coinbase Exchange rather than on Coinbase International Exchange. For data returned by Coinbase Exchange, please refer to the Coinbase Exchange API documentation.

REST API

List instruments, Get instrument details

The following only applies for spot instruments configured to route spot orders to Coinbase Exchange.

Property	Type	Description
qty_24hr	string	Forwarded from Coinbase Exchange
avg_daily_qty	string	Forwarded from Coinbase Exchange
previous_day_qty	string	Forwarded from Coinbase Exchange
trading_state	string	New available options include: `AUCTION_MODE`, `CANCEL_ONLY`, `POST_ONLY`, `LIMIT_ONLY`, `TRADING_DISABLED`, `CANCEL_ONLY_ENFORCED_BY_COINBASE_INTERNATIONAL_EXCHANGE`, `COINBASE_EXCHANGE_UNREACHABLE` All new options, except for the following, are forwarded from Coinbase Exchange. `CANCEL_ONLY_ENFORCED_BY_COINBASE_INTERNATIONAL_EXCHANGE` means Coinbase International Exchange only permits order cancellation separately from Coinbase Exchange. `COINBASE_EXCHANGE_UNREACHABLE` means the Coinbase International Exchange component is unable to establish connectivity with Coinbase Exchange
notional_24hr	string	Will not be populated
avg_daily_notional	string	Will not be populated
quote → best_bid_price	string	Forwarded from Coinbase Exchange
quote → best_ask_price	string	Forwarded from Coinbase Exchange
quote → best_bid_size	string	Forwarded from Coinbase Exchange
quote → best_ask_size	string	Forwarded from Coinbase Exchange
quote → trade_price	string	Forwarded from Coinbase Exchange
quote → trade_size	string	Forwarded from Coinbase Exchange
quote → limit_up	string	Will not be populated
quote → limit_down	string	Will not be populated

Get quote per instrument

The following only applies for spot instruments configured to route spot orders to Coinbase Exchange.

Property	Type	Description
best_bid_price	string	Forwarded from Coinbase Exchange
best_ask_price	string	Forwarded from Coinbase Exchange
best_bid_size	string	Forwarded from Coinbase Exchange
best_bid_size	string	Forwarded from Coinbase Exchange
trade_price	string	Forwarded from Coinbase Exchange
trade_size	string	Forwarded from Coinbase Exchange
limit_up	string	Will not be populated
limit_down	string	Will not be populated

Get daily trading volumes

The following only applies for spot instruments configured to route spot orders to Coinbase Exchange.

Property	Type	Description
instruments → notional	string	Will not be populated
totals → total_instruments_volume	string	Excludes spot instruments which route orders to Coinbase Exchange
totals → total_instruments_notional	string	Excludes spot instruments which route orders to Coinbase Exchange
totals → total_exchange_volume	string	Excludes spot instruments which route orders to Coinbase Exchange
totals → total_exchange_notional	string	Excludes spot instruments which route orders to Coinbase Exchange

Get aggregated candles data per instrument

Not supported for spot instruments configured to route orders to Coinbase Exchange.

Create order, Get order details, Cancel order, Cancel orders

The following only applies for orders routed to Coinbase Exchange.

Property	Type	Description
text	string	Value may be forwarded from Coinbase Exchange

List fills by portfolios

The following only applies for fills executed on Coinbase Exchange.

Property	Type	Description
execution_venue	string	The following values for fills executed on Coinbase Exchange will be added: `COINBASE_EXCHANGE_CLOB` for fills executed by Coinbase Exchange’s central limit order book `COINBASE_EXCHANGE_RFQ` for fills executed by Coinbase Exchange’s request for quote engine Existing values will remain unchanged

FIX API, Order Entry & Drop Copy

ExecutionReport (35=8)

The following only applies for orders routed to Coinbase Exchange. A few OrdRejReason values previously included in the Upcoming Changes page will not be added because they already exist in the XML spec.

Tag	Name	Type	Required	Notes
103	OrdRejReason	int	C	For spot orders routed to Coinbase Exchange, new potential values include: 49 = BROKER 51 = EXCHANGE_CLOSED 52 = ORDER_EXCEEDS_LIMIT 53 = TOO_LATE_TO_ENTER 55 = DUPLICATE_OF_A_VERBALLY_COMMUNICATED_ORDER 56 = STALE_ORDER 57 = TRADE_ALONG_REQUIRED 58 = INVALID_INVESTOR_ID 59 = UNSUPPORTED_ORDER_CHARACTERISTIC 60 = SURVEILLENCE_OPTION 61 = INCORRECT_ALLOCATED_QUANTITY 62 = UNKNOWN_ACCOUNT 64 = COINBASE_EXCHANGE_DEPOSIT_FAILED
1430	VenueType	char	N	The following existing values for orders executed on Coinbase International Exchange will be renamed to: E = COINBASE_INTERNATIONAL_EXCHANGE_ELECTRONIC_EXCHANGE N = COINBASE_INTERNATIONAL_EXCHANGE_QUOTE_NEGOTIATION The following values for spot orders routed to Coinbase Exchange will be added: X = COINBASE_EXCHANGE_ELECTRONIC_EXCHANGE Q = COINBASE_EXCHANGE_QUOTE_NEGOTIATION Values suffixed with ELECTRONIC_EXCHANGE indicate trades which occur on the central limit order book (CLOB). Values suffixed with QUOTE_NEGOTIATION indicate trades through an RFQ process
58	Text	string	N	Value may be forwarded from Coinbase Exchange

OrderCancelReject (35=9)

The following only applies for spot orders routed to Coinbase Exchange. A few OrdRejReason values previously included in the Upcoming Changes page will not be added because they already exist in the XML spec.

Tag	Name	Type	Required	Notes
102	CxlRejReason	int	N	For spot orders routed to Coinbase Exchange, new potential values include: 27 = BROKER 28 = UNABLE_TO_PROCESS_ORDER_MASS_CANCEL_REQUEST 29 = ORIGORDMODTIME 30 = DUPLICATE_CLORDID 31 = PRICE_EXCEEDS_CURRENT_PRICE
58	Text	string	N	Value may be forwarded from Coinbase Exchange

PreFillReport (35=F8)

Not sent for spot orders routed to Coinbase Exchange.

FIX API, Market Data

For spot instruments configured to route spot orders to Coinbase Exchange, all values represent the unless otherwise noted,

SecurityList (35=y) & SecurityDefinition (35=d)

The following only applies for spot instruments configured to route spot orders to Coinbase Exchange.

Tag	Name	Type	Required	Notes
871	InstrAttribType	int	Y	The following values are not sent: 40 = Average daily notional amount 42 = Total day notional amount (30 days) 44 = Total hour notional amount (24 hours) Other values are forwarded from Coinbase Exchange
1682	MDSecurityTradingStatus	int	Y	New values include: 100 = AUCTION_MODE 101 = CANCEL_ONLY 102 = POST_ONLY 103 = LIMIT_ONLY 104 = TRADING_DISABLED 105 = CANCEL_ONLY_ENFORCED_BY_COINBASE_INTERNATIONAL_EXCHANGE 106 = COINBASE_EXCHANGE_UNREACHABLE All new options, except for the following, are forwarded from Coinbase Exchange. `CANCEL_ONLY_ENFORCED_BY_COINBASE_INTERNATIONAL_EXCHANGE` means Coinbase International Exchange only permits order cancellation separately from Coinbase Exchange. `COINBASE_EXCHANGE_UNREACHABLE` means the Coinbase International Exchange component is unable to establish connectivity with Coinbase Exchange

MarketDataSnapshotFullRefresh (35=W) & MarketDataIncrementalRefresh (35=X)

The following only applies for spot instruments configured to route spot orders to Coinbase Exchange.

Tag	Name	Type	Required	Notes
269	MDEntryType	char	Y	The following values are not sent: 4 = Opening price g = Fair value limit up h = Fair value limit down Other values are forwarded from Coinbase Exchange
2446	AggressorSide	int	C	Forwarded from Coinbase Exchange

WebSocket Feed

INSTRUMENTS Channel

The following only applies for spot instruments configured to route spot orders to Coinbase Exchange. Response

Property	Description
trading_state	New available options include: `auction_mode`, `cancel_only`, `post_only`, `limit_only`, `trading_disabled`, `cancel_only_enforced_by_coinbase_international_exchange`, `coinbase_exchange_unreachable` All new options, except for the following, are forwarded from Coinbase Exchange. `cancel_only_enforced_by_coinbase_international_exchange` means Coinbase International Exchange only permits order cancellation separately from Coinbase Exchange. `coinbase_exchange_unreachable` means the Coinbase International Exchange component is unable to establish connectivity with Coinbase Exchange
avg_daily_quantity	Forwarded from Coinbase Exchange
total_30_day_quantity	Forwarded from Coinbase Exchange
total_24_hour_quantity	Forwarded from Coinbase Exchange
avg_daily_volume	Will not be populated
total_30_day_volume	Will not be populated
total_24_hour_volume	Will not be populated
indicative_open_price	Will not be populated
min_quantity	Will not be populated

CANDLES Channel

Not supported for spot instruments configured to route orders to Coinbase Exchange.

2025-OCT-23

Instrument Definition Updates

REST API
- Added min_quantity field to response from List Instruments and Get Instrument Details endpoints

2025-OCT-16

Address Book

REST API
- New Get Address Book endpoint to retrieve all saved withdrawal recipients

2025-AUG-14

Users can now query position transfers with the new transfer type POSITION_TRANSFER.

REST API
- New transfer type in Get Transfers endpoint:
  - New supported type: POSITION_TRANSFER

2025-AUG-06

Adding two new fields for external collateral users.

REST API
- New fields unreconciled_amount and max_undelegate_amount for

2025-JUN-23

Two-Sided Position Limits

Introducing two-sided position limits for perpetual futures position limit accounting. In this model, long position notional and short position notional values are tracked separately, and the maximum value across the account is the effective value when determining limit breach

REST API
- New values in Position response for Get Portfolio Position and List Portfolio Positions:
  - open_position_notional: max(long_open_position_notional, short_open_position_notional)
  - long_open_position_notional
  - short_open_position_notional

Disable Loan Overdraft Protection on a Portfolio

We are adding support to disable loan overdraft protection on a per-portfolio basis. Overdraft loans will not be issued during settlement or any loan acquisition processes that are not initiated by the user.

REST API
- New parameter to enable/disable overdraft protection to Portfolio Patch endpoint:
  - disable_overdraft_protection

2025-APR-24

Margin Call

Introducing margin call functionality for underwritten clients.

REST API
- New margin call status endpoint to get margin call status for a portfolio
- New parameter, marginCallEnabled, to enable/disable margin call to portfolio patch endpoint
- Added destination_tag to the Withdraw to crypto address endpoint to support transfers for additional assets

TP/SL Order Replace

Added support for replacing TP/SL orders:

FIX API
- Added a new field StopLimitPx (tag 3040) to the OrderCancelReplaceRequest (35=G) message.
- Updated the FIX dictionary download link
REST API
- Added a new filed stop_limit_price to the Modify order in the REST API.

Higher FIX API Key-level Rate Limits

We have increased FIX API key-level rate limits:

Increase FIX messages per second per API key from 400 to 800.
Increase FIX disconnect threshold messages per second per API key from 700 to 1000.

2025-MAR-27

FIX API Added new FIX messages for Request For Quote (RFQ). The new FIX messages are:
WebSockets
- Added the RFQ MATCH channel to provide real-time information every time an RFQ trade happens.
REST API
- Get Instrument Details and List Instruments endpoints
  - Add new field to indicate fee rate charged for rfq quotes: rfq_maker_fee_rate
- Get Portfolio Fills and List Portfolio Fills endpoints
  - Add new field to indicate execution venue: execution_venue [RFQ, CLOB]

2025-MAR-13

Introducing 2 new endpoints to get portfolio transfer limits.

REST API
- Get transfer limit between portfolios
- Get counterparty withdrawal limit
- The existing Counterparty transfer endpoint now supports transfer of borrowed funds.

2025-FEB-27

Added transfer activity to the Get Transfers endpoint representing automatic portfolio to portfolio balance transfers made to cover losses during liquidation.

REST API
- Added new transfer activity to the Get Transfers endpoint
  - New supported types: LIQUIDATION_EQUITY_CLAWBACK

2025-FEB-13

Introducing 3 new endpoints to get portfolio open position notional limits.

REST API

Adding Real Time Settlement Transfer events to the Get Transfers endpoint.

REST API
- Add real time settlement transfers to the Get Transfers endpoint
  - New supported types: REAL_TIME_SETTLEMENT

2025-FEB-06

Session CancelOnDisconnect Default Behavior

The default value for both CancelOrdersOnDisconnect and CancelOrdersOnInternalDisconnect in the FIX Logon message changed from N (No cancel on disconnect) to Y (Only cancels orders from this session). CancelOrdersOnDisconnect (Tag 8013)

Old Default: N (No cancel on disconnect)
New Default: Y (Only cancels orders from this session)

CancelOrdersOnInternalDisconnect (Tag 8014)

Old Default: N (No cancel on internal disconnect)
New Default: Y (Only cancels orders from this session)

2025-JAN-16

Replacing quantity risk limits with notional ones:

REST API
- position_notional_limit and open_interest_notional_limit to the List instruments and Get instrument details response objects.
FIX API
- New PositionLimit field (tag 970) in Market Data. This a new field is on the SecurityDefinition message
- The field MaxTradeVol will be deprecated in the future changes.
Order rejection uses UBO_HIGH_LEVERAGE_NOTIONAL_BREACHED instead of UBO_HIGH_LEVERAGE_QUANTITY_BREACHED.
Updated the FIX dictionary download link

Adding new instrument trading state EXTERNAL:

EXTERNAL Trading State
- Instruments that have an EXTERNAL trading status are not currently traded on this market. This is used to derive collateral value of instruments that does not have a quoted USDC price.
REST API
- Added trading_state value EXTERNAL to the List instruments and Get instrument details response objects.
FIX API
- Added MdSecurityTradingStatus (Tag 1682) value 19 (Not Traded On This Market) to SecurityDefinition and SecurityList messages
WEB MD API
- Added trading_state value external to the INSTRUMENTS Channel response.
- WEB MD API will not subscribe to MDA candles data for external instruments
- WEB MD API will reject client subscription requests to all channels except RISK and INSTRUMENT for external instruments
Updated cb_intx_fix_dictionaries_latest.tar.gz for download

2024-DEC-18

REST API
- Populated txn_hash for both on-chain deposits and on-chain withdrawals in the responses for Get transfer and Get transfers.

2024-DEC-13

REST API
- Added instrument_symbol and txn_hash field to the responses for Get transfer and Get transfers respectively.
  - txn_hash will be present for on-chain deposit transfers
  - instrument_symbol will be present for funding transfers

2024-NOV-25

Added support for Exchange Loans

REST API
- Added Update Loan endpoint to acquire/repay existing loans
- Added Preview Loan endpoint to preview the portfolio state after acquiring a loan
- Added Loan Availability endpoint to retrieve the maximum loan amount available for the specified asset
- Added Get Portfolio Loans endpoint to view all loans for a portfolio
- Added Get Portfolio Loan endpoint to view the existing loan state for the specified asset
- Changes to fields in the Balance response object
  - Added collateral_backed_overdraft_loan amount (quantity) of outstanding loan taken due to overdrafting USDC on a debit
  - Added user_requested_loan amount (quantity) of outstanding loan requested by the user
  - Changed loan to be the total loan amount (quantity) outstanding. Sum of collateral_backed_overdraft_loan and user_requested_loan
  - Added loan_initial_margin_contribution the amount of initial margin required to hold the existing loan
- Changes to the fields in the Asset response object
  - Added loan_initial_margin the percentage of initial margin requirement for taking a loan on the asset
  - Added max_loan_leverage the maximum amount leverage that can be used when taking a loan on the asset
- Added loan activity to the Get Transfers endpoint
  - New supported types: LOAN_ACQUIRE, LOAN_REPAY, LOAN_INTEREST_CHARGE, and ALL_LOANS
  - The ALL_LOANS type will include all transfers related to acquire, repay, and interest charge activity

2024-NOV-21

Added new text field to denote cancel reason in get order endpoint

2024-NOV-12

Added new REST API endpoints for retrieving index data:

2024-OCT-24

API changes for TWAP orders:

FIX API
- Added TargetStrategy (Tag 847) to NewOrderSingle and ExecutionReport messages
REST API
- Added algo_strategy to the Create order request object and its response

2024-SEP-12

Adding new FIX field to instrument definition:

FIX API
- Added NoUnderlyings (Tag 711) to SecurityDefinition and SecurityList messages

2024-SEP-10

Added new instrument trading state DELISTED:

REST API
- Added trading_state value DELISTED to the List instruments and Get instrument details response objects.
FIX API
- Added MdSecurityTradingStatus (Tag 1682) value 18 (Not Available to Trade) to SecurityDefinition and SecurityList messages
WEB MD API
- Added trading_state value delisted to the INSTRUMENTS Channel response

2024-SEP-03

Adding new FIX messages for the PreFills API. The new FIX messages are:

2024-AUG-20

Adding new field underlying_type which represents the underlying asset type. The enhanced REST API endpoints are:

2024-JUL-30

Renamed fill_source to source in REST API endpoints:

2024-JUL-22

Added fill_source (LIQUIDATION, CLIENT_ORDER) to REST API endpoints:

2024-JUL-11

Updated and added rate limits:

Updated REST requests per second per API Key from 100 to 40
Updated Maximum API Keys per account to:
- Maximum trading API Keys per account: 30
- Maximum non-trading API Keys per account: 20
Added Maximum connection attempts every 30 seconds: 10

2024-JUN-17

Added support for Pre-Launch Markets. Pre-Launch Markets let users trade perpetual futures contracts on tokens that have not launched yet. When an underlying token is launched on an applicable spot exchange, the instrument converts to a standard perpetual contract. Learn more in our Help Center.

REST API
- Added mode (STANDARD, PRE_LAUNCH, PRE_LAUNCH_CONVERTING) to the List instruments and Get instrument details response objects.
- Added pre_launch_trading_enabled to the Patch portfolio request and Get user portfolio response objects.
FIX API
- Added SecuritySubType (Tag 762) (STANDARD, PRE_LAUNCH, PRE_LAUNCH_CONVERTING) to SecurityDefinition and SecurityList messages
- Added repeating group NoEvents (864) under the Instrument Component in the SecurityDefinition and SecurityList messages
- Updated the FIX dictionary download link
WEB MD API
- Added instrument_mode (standard, pre_launch, pre_launch_converting) and pre_launch_conversion_time to the INSTRUMENTS Channel response

2024-JUN-06

WebSockets
- Added the CANDLES channels for market data.

2024-MAY-23

REST API
- Added List position offsets REST endpoint
- Added close_only field to the Create order request object.
- Added close_only field to the Get order details and List open orders response objects.
- Added base_asset_multiplier field to the List instruments and Get instrument details response objects.
FIX API
- Added CLOSE_ONLY to the supported ExecInst values of the NewOrderSingle and ExecutionReport messages in the order entry fix dictionary.
- Added CLOSE_ONLY to the supported ExecInst values of the ExecutionReport message in the drop copy fix dictionary.
- Added ContractMultiplier (Tag 231) to SecurityDefinition and SecurityList messages
- Updated the FIX dictionary download link
WEB MD API
- Added base_asset_multiplier to the INSTRUMENTS Channel response

2024-MAY-13

Added Patch portfolio REST endpoint

2024-MAY-02

Added the order_type and side parameters to List open orders REST endpoint

2024-APR-25

Added the following REST endpoints:

2024-APR-17

Added portfolio Auto Margin:

Portfolios automatically post the collateral required to exceed high leverage limits on a per-instrument basis.
Portfolio margin requirements are calculated based on the newly introduced default initial margin instrument field.
Users can opt-in to the Auto Margin feature on a per-portfolio basis.

Instrument Definitions

Added the following instrument definitions for Auto Margin:

default_imf to Get instrument details and List instruments
default_imf to the WebSocket INSTRUMENTS Channel
DefaultMarginRatio to the FIX API Market Data SecurityDefinition message
Updated the FIX dictionary download link

Portfolio Endpoints

Added an endpoint to Enable/Disable portfolio auto margin

2024-APR-02

Updated REST and FIX API to support TP/SL orders:

Added new field stop_limit_price and new option TAKE_PROFIT_STOP_LOSS for field order_type on the REST API order create, order details and order list
Added new field StopLimitPx (tag 3040) and new option O for field OrderType on the FIX Order Entry API NewOrderSingle and ExecutionReport messages

2024-MAR-27

Added support for portfolio cross collateral:

Added opt-in endpoint, Enable/Disable portfolio cross collateral
Updated the responses for the following APIs with loan and collateral information:

2024-MAR-26

Added new REST API for position transfer — requires trade permission:

Transfer positions between portfolios

2024-MAR-19

Added new REST APIs for fee rate tiers:

2024-FEB-27

Added OrderMassCancelRequest and OrderMassCancelReport messages to the FIX Order Entry API
Added the side parameter to the Cancel Orders REST endpoint for bulk order cancels

2024-FEB-22

Made the International Exchange OpenAPI Specification available for download.

2024-FEB-06

Increased Maximum API keys per account to 20.

2024-JAN-30

Added id field to portfolio position related endpoints to denote position ID.
Exposed position_id on transfers of type FUNDING to the Get transfers response.
Added new hold_available_for_collateral field to Get portfolio details, Get balance for portfolio/asset, and List portfolio balances REST endpoints.

2024-JAN-23

Added instrument_id field to the responses for Get transfer and Get transfers for transfers of type FUNDING

2024-JAN-15

Added new transfer endpoints:
Added from_counterparty_id and to_counterparty_id to List matching transfers and Get transfer REST endpoints.

2024-JAN-11

Added new instrument endpoint: Get historical funding rates
Added new transfer type FUNDING to Transfer related endpoints

2023-DEC-13

Added fields from response of /instruments/{instrument}/quote, as a quote object, to the responses of /instruments and /instruments/{instrument}.

2023-DEC-12

Added aggressor_sideto web market data MATCH Channel.
Replaced old return type with portfolio_id and margin_override fields in portfolio endpoint: Set portfolio margin override

2023-DEC-05

Added guidance on FIX and REST API Rate Limits.

2023-NOV-28

Added portfolio_initial_margin_notional, portfolio_current_margin_notional, portfolio_maintenance_margin_notional and portfolio_close_out_margin_notional to Get portfolio summary and Get portfolio details REST endpoints.

2023-NOV-27

Added new portfolio endpoint: Set portfolio margin override
Updated description of MaxTradeVol in FIX SecurityList and SecurityDefinition messages.
Updated response comment descriptions for WebSockets INSTRUMENTS Channel

2023-NOV-24

Added Cancel resting order option (8000=O) to SelfTradePreventionStrategy tag:
- Trading NewOrderSingle (35=D)
- Trading ExecutionReport (35=8)

2023-NOV-09

Added Decrement and cancel resting order option (8000=D) to SelfTradePreventionStrategy tag
- Drop Copy ExecutionReport (35=8)

2023-NOV-08

Added portfolio_maintenance_margin and portfolio_close_out_margin to Get portfolio summary and Get portfolio details REST endpoints.

2023-OCT-30

Added new portfolio endpoints:
- Get portfolio
- Create portfolio
- Update portfolio
- List fills by portfolios
- Transfer funds between portfolios (requires transfer permission)
Added ability to query transfers by multiple portfolios:
- Get transfers

2023-OCT-19

Updated the field type of LastUpdateTime from UTCDATEONLY to UTCTIMESTAMP in SecurityDefinition in FIX50 Market Data Dictionary

2023-OCT-18

Added open_interest to WebSocket feed, FIX Market Data API, and REST API.

2023-SEP-28

Added new endpoint /transfers/withdraw: Withdraw to crypto address
Multi-chain support for USDC transfers on Base/Optimism networks

2023-JUL-21

Added support for multi-chain/gasless transfers. Users are now able to deposit and withdraw USDC on Arbitrum, Avalanche, Ethereum, Polygon, and Solana networks.
Added 24h/30d volume figures to
Improved REST API latency
Updated the INTX UI with a new Transfers History page and 24h/30d volume figures

2023-JUL-11

Added tarball of FIX dictionaries for download.

2023-JUN-01

WebSocket

Added WebSocket Market Data API

REST API

Added new endpoint /transfers:
Added ability to filter on a specific order_id for fills endpoint:
- List portfolio fills

INTX UI

Publish 24h volume on Markets page
Fixed issue displaying “Short” positions

2023-MAY-19

Improved overall system performance and stability. Features include:

20 new price levels on the FIX Market Data feed.
Reduced latency of the REST API orders endpoint.
Ability to fetch REST API orders under the same portfolio.

2023-MAY-02

Public preview of the Coinbase International Exchange FIX and REST APIS.

​2026-Jun-11

​Underlying Security Type

FIX API, Market Data

SecurityDefinition (35=d) & SecurityList (35=y)

​2026-Jun-03

​Underlying Security Type

REST API, WebSocket Feed

​2026-Apr-22

​Underlying Security Type

REST API, WebSocket Feed

FIX API, Market Data

SecurityDefinition (35=d) & SecurityList (35=y)

​2026-Mar-19

​Underlying Security Type

REST API, WebSocket Feed

FIX API, Market Data

SecurityDefinition (35=d) & SecurityList (35=y)

​2026-FEB-19

​FIX Market Data: MarketDataIncrementalRefresh MDEntry’s where MDEntryType=BID|OFFER: New LastFragment and MDEntryTime fields

MDEntryType=BID|OFFER Batch Fragmentation

​2026-Jan-22

​Position Transfer Metadata

​2025-DEC-19

​Cursor-Based Pagination for Transfers

​2025-NOV-20

​Position Transfer Metadata

​2025-NOV-18

​Spot Order Routing to Coinbase Exchange: Addendum for REST API’s List instruments, Get instrument details, Get quote per instrument endpoints

List instruments, Get instrument details

Get quote per instrument

​2025-NOV-13

​Spot Order Routing to Coinbase Exchange

REST API

List instruments, Get instrument details

Get quote per instrument

Get daily trading volumes

Get aggregated candles data per instrument

Create order, Get order details, Cancel order, Cancel orders

List fills by portfolios

FIX API, Order Entry & Drop Copy

ExecutionReport (35=8)

OrderCancelReject (35=9)

PreFillReport (35=F8)

FIX API, Market Data

SecurityList (35=y) & SecurityDefinition (35=d)

MarketDataSnapshotFullRefresh (35=W) & MarketDataIncrementalRefresh (35=X)

WebSocket Feed

INSTRUMENTS Channel

CANDLES Channel

​2025-OCT-23

​Instrument Definition Updates

​2025-OCT-16

​Address Book

​2025-AUG-14

​2025-AUG-06

​2025-JUN-23

​Two-Sided Position Limits

​Disable Loan Overdraft Protection on a Portfolio

​2025-APR-24

​Margin Call

​TP/SL Order Replace

​Higher FIX API Key-level Rate Limits

​2025-MAR-27

​2025-MAR-13

​2025-FEB-27

​2025-FEB-13

​2025-FEB-06

​Session CancelOnDisconnect Default Behavior

​2025-JAN-16

​2024-DEC-18

​2024-DEC-13

​2024-NOV-25

​2024-NOV-21

​2024-NOV-12

​2024-OCT-24

​2024-SEP-12

​2024-SEP-10

​2024-SEP-03

​2024-AUG-20

​2024-JUL-30

2026-Jun-11

Underlying Security Type

2026-Jun-03

Underlying Security Type

2026-Apr-22

Underlying Security Type

2026-Mar-19

Underlying Security Type

2026-FEB-19

FIX Market Data: `MarketDataIncrementalRefresh` `MDEntry`’s where `MDEntryType=BID|OFFER`: New `LastFragment` and `MDEntryTime` fields

`MDEntryType=BID|OFFER` Batch Fragmentation

2026-Jan-22

Position Transfer Metadata

2025-DEC-19

Cursor-Based Pagination for Transfers

2025-NOV-20

Position Transfer Metadata

2025-NOV-18

Spot Order Routing to Coinbase Exchange: Addendum for REST API’s `List instruments`, `Get instrument details`, `Get quote per instrument` endpoints

2025-NOV-13

Spot Order Routing to Coinbase Exchange

2025-OCT-23

Instrument Definition Updates

2025-OCT-16

Address Book

2025-AUG-14

2025-AUG-06

2025-JUN-23

Two-Sided Position Limits

Disable Loan Overdraft Protection on a Portfolio

2025-APR-24

Margin Call

TP/SL Order Replace

Higher FIX API Key-level Rate Limits

2025-MAR-27

2025-MAR-13

2025-FEB-27

2025-FEB-13

2025-FEB-06

Session CancelOnDisconnect Default Behavior

2025-JAN-16

2024-DEC-18

2024-DEC-13

2024-NOV-25

2024-NOV-21

2024-NOV-12

2024-OCT-24

2024-SEP-12

2024-SEP-10

2024-SEP-03

2024-AUG-20

2024-JUL-30

2024-JUL-22

2024-JUL-11

2024-JUN-17

2024-JUN-06

2024-MAY-23

2024-MAY-13

2024-MAY-02

2024-APR-25

2024-APR-17

Instrument Definitions

Portfolio Endpoints

2024-APR-02

2024-MAR-27

2024-MAR-26

2024-MAR-19

2024-FEB-27

2024-FEB-22

2024-FEB-06

2024-JAN-30

2024-JAN-23

2024-JAN-15

2024-JAN-11

2023-DEC-13

2023-DEC-12

2023-DEC-05

2023-NOV-28

2023-NOV-27

2023-NOV-24