INTX Changelog

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

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
    • Get Balance For Portfolio/Asset
    • List Portfolio Balance
    • Get Portfolio Details

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 cb_intx_fix_dictionaries_latest.tar.gz for download.

• 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:
  • RFQRequest
  • QuoteRequest
  • Quote
  • QuoteStatusReport
• 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
  • Get the total open position limit for the portfolio
  • List the open position limits for all instruments
  • Get the open position limits for the portfolio instrument

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 cb_intx_fix_dictionaries_latest.tar.gz for download

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:

• Get index composition
• Get index composition history
• Get index price
• Get index candles

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:

• PreFillRequest
• PreFillReport

2024-AUG-20

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

• List instruments
• Get instrument details

2024-JUL-30

Renamed fill_source to source in REST API endpoints:

• List portfolio fills
• List fills by portfolios

2024-JUL-22

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

• List portfolio fills
• List fills by portfolios

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:

• Get daily trading volumes
• Get aggregated candles data per instrument

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:
  • List portfolio balances
  • Get portfolio details
  • Get asset details
  • List assets

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:

• List fee rate tiers
• List portfolio fee rates

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:
  • Create counterparty id
  • Validate a counterparty id
  • Withdraw to a counterparty id
• 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
  • FIX MarketData SecurityList
  • FIX MarketData SecurityDefinition
  • WebSocket Instruments Channel
• 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:
  • List matching transfers
  • Get transfer
  • Create crypto address
• 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.