INTX Changelog

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

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