These release notes list changes to Coinbase Prime Broker.

2025-AUG-01

Added support for counterparty transfers via the Coinbase Transfer Network, enabling instant and fee-less transfers between Coinbase customers. Prime Rest API:
  • Get Portfolio Counterparty ID: GET /v1/portfolios/{portfolio_id}/counterparty - retrieve your portfolio’s unique counterparty ID for receiving transfers
  • Create Withdrawal now supports DESTINATION_COUNTERPARTY destination type for sending transfers to other Coinbase customers
Usage Examples:
  1. Get your portfolio’s counterparty ID:
Request:
{
  "portfolio_id": "11111111-1111-1111-1111-111111111111"
}
Response:
{
  "counterparty": {
    "counterparty_id": "CB12345678"
  }
}
  1. Send transfer to another portfolio:
Request:
{
  "portfolio_id": "11111111-1111-1111-1111-111111111111",
  "wallet_id": "22222222-2222-2222-2222-222222222222",
  "amount": "10",
  "destination_type": "DESTINATION_COUNTERPARTY",
  "idempotency_key": "33333333-3333-3333-3333-333333333333",
  "currency_symbol": "BTC",
  "counterparty": {
    "counterparty_id": "CB12345678"
  }
}
Response:
{
    "activity_id": "44444444-4444-4444-4444-444444444444",
    "approval_url": "https://prime.coinbase.com/portfolio/11111111-1111-1111-1111-111111111111/activity/44444444-4444-4444-4444-444444444444",
    "symbol": "BTC",
    "amount": "10",
    "fee": "",
    "destination_type": "Counterparty",
    "source_type": "BTC Trading Balance",
    "counterparty_destination": {
        "counterparty_id": "CB12345678"
    },
    "transaction_id": "55555555-5555-5555-5555-555555555555"
}

2025-JUL-29

Staking Solana (SOL) now enabled with validator address support. Prime Rest API:
  • Initiate Staking now supports optional validator_address parameter
    • For SOL staking only, optional validator_address must be the vote account address. Defaults to Coinbase validator when not specified.
  • Unstake input schema updated to exclude validator_address parameter (staking-only)
  • Updated amount parameter descriptions to specify “(ETH only)” behavior for both staking and unstaking

2025-JUL-22

Added support for Post-Only instructions on limit orders Prime Rest API: Prime FIX API:
  • Additional value for NewOrder (D): Support for Post-Only Orders
  • Tag 18 (ExecInst): A (Post-Only)
  • Supported TimeInForce values:
    • 6 = GTD (Good Till Date)
    • 1 = GTC (Good Till Cancel)
  • Notes
    • Post-Only orders (18=A) are now supported with TImeInForce values of GTD and GTC

2025-JUL-14

  • Added the following fields to Products and Products Channel for Websocket feed inside rfq_product_detail:
    • min_base_size The minimum the size can be when submitted in the base asset
    • max_base_size The maximum the size can be when submitted in the base asset
    • min_quote_size The minimum the size can be when submitted in the quote asset
    • max_quote_size The maximum the size can be when submitted in the quote asset

2025-JUN-18

  • Added support for Prime Limit Fill or Kill (FOK) order with size in quote order instructions.
    • FIX CashOrderQty(152) with TimeInForce(59) FILL_OR_KILL
    • REST create order quote_value with time_in_force FILL_OR_KILL

2025-APR-7

  • Added the following field to Products and Products Channel for Websocket feed:
    • rfq_product_detail contains product details for placing RFQ orders, which includes the following sub-fields:
      • tradable determines if the product is tradable for RFQ
      • min_notional_size is the minimum notional size for RFQ orders
      • max_notional_size is the maximum notional size for RFQ orders

2025-MAR-27

Created API references for the following Prime endpoints

2025-MAR-24

2025-FEB-26

Added support for Request For Quote Prime Rest API: Prime FIX API:

2025-FEB-12

  • Updated the following endpoints to support the new network field for Prime Multinetwork Support:
    • List Assets, will return network_details for each asset supported by the entity
    • List Portfolio Transactions, will return the network field in the response if the transaction is onchain
    • List Wallet Transactions, will return the network field in the response if the transaction is onchain
    • Get Transaction by Transaction ID, will return the network field in the response if the transaction is onchain
    • Create Withdrawal, will take in optional network field as a request parameter and return the network field in the response if the withdrawal is onchain
    • List Portfolio Wallets, will return the network field in the response if the wallet is a vault wallet
    • Get Wallet by Wallet ID, will return the network field in the response if the wallet is a vault wallet
    • Create Wallet, will take in optional network field as a request parameter and return the network field in the response if the wallet is a vault wallet
    • Get Wallet Deposit Instructions, will take in the optional network field as a request parameter and return the network field in the response if the deposit instruction is onchain

2025-JAN-31

2024-JAN-17

  • Added FCM futures API series including

2024-DEC-17

2024-DEC-12

2024-DEC-05

Added product_id field to Orders Channel’s messages.

2024-OCT-18

Added support for filtered Level2 Data Channel by venue configuration for Websocket feed:
  • Updated L2_data channel request to include venue_filtering boolean.
  • Updated L2_data channel response to include venue_configuration for each product.

2024-OCT-15

2024-OCT-2

2023-NOV-20

Added support for Stop Limit orders:
  • Updated Create Order and Get Order Preview with order type STOP_LIMIT, a conditional order combined of stop order and limit order. The stop_price field is required for this new order type.
  • Added FIX Target Strategy Type SL for the new Stop Limit order and StopPx (99) to NewOrderSingle.

2023-OCT-31

2023-OCT-26

  • Updated Create Order and Get Order Preview with new parameter called historical_pov that estimates participation rate for a TWAP/VWAP order. Can be specified instead of expiry time.

2023-SEP-11

  • Updated FIX tag TargetStrategy (847) by adding Immediate or Cancel (IOC) support to NewOrderSingle LIMIT orders.

2023-SEP-08

Added endpoints to support Net Allocations:

2023-AUG-28

2023-AUG-10

Updated List Open Orders:
  • Fixed query parameters order_type, order_side, sort_direction, start_date, and end_date which can again be used to filter orders.
  • Deprecated query parameters limit, and cursor.
  • Deprecated field pagination from response payload.

2023-AUG-08

2023-JUL-25

  • Updated FIX TimeInForce (59) with support for Fill or Kill (FOK).

2023-JUN-29

Added volume-weighted average price trading (VWAP):

2023-MAR-17

Added 2 new response properties to Get Portfolio credit Information:
  • adjusted_credit_utilized
  • adjusted_portfolio_equity

2023-MAR-09

  • Enabled Replay for all FIX clients.

2023-FEB-10

  • Added FIX tag IsRaiseExact (8999) to NewOrderSingle messages for all order types (LIMIT, MARKET, TWAP).

2023-JAN-24

2022-NOV-09

  • Fixed WebSocket bug whereby clients subscribed to Orders Channels could receive updates from product IDs different from the ones provided in subscription message.

2022-OCT-19

Updated WebSocket:
  • Improved performance of server’s resource usage.
  • Added new time formatting definition fields, timestamp and event_time.

2022-SEP-02

Added 3 new response properties to Get Portfolio Allocations:
  • allocation_completed_at
  • order_ids
  • fees_allocated_leg of destination level

2022-AUG-12

Added new endpoint List Portfolio Allocations returns a list of allocations.

2022-AUG-10

  • Updated List Open Orders, List Portfolio Orders:
    • Users can now filter by a new order_type called: BLOCK
    • Added a new possible value BLOCK to the field type, which refers to a block trade
  • Updated Get Order by Order ID:
    • Added a new possible value BLOCK to the field type, which refers to a block trade

2022-JUL-27

  • Updated List Open Orders, Get Order by Order ID, and List Portfolio Orders:
    • Users can now see a field exchange_fee, populated when the order was placed with a COST_PLUS commission configuration.
  • Added the following fields to List Portfolio Balances, Get Wallet Balance:
    • bonded_amount is the amount currently locked due to bonding/staking, potentially subject to an unbonding period, in whole units
    • reserved_amount is the amount that must remain in the wallet due to the protocol, in whole units
    • unbonding_amount is the amount that is in the process of unbonding, in whole units
    • unvested_amount is the unrealized amount subject to a vesting schedule, in whole units
    • pending_rewards_amount is the pending bonding/staking rewards that have not yet been realized, in whole units
    • past_rewards_amount is the previously realized bonding/staking rewards, in whole units
    • bondable_amount is the amount available for bonding/staking, in whole units

2022-JUL-01

Added support for conversions:

2022-JUN-08

2022-MAY-19

2022-APR-22

  • Updated List Portfolio Orders:
    • The product_ids parameter is no longer required. If not specified you get all products.
    • The 31 day limit has been removed so you can now request orders for any time period using start_date and end_date. The end_date parameter is still optional, but if not specified you get orders from start_date to the end of time. Previously, it returned start_date to start_date + 31 days.
  • Updated List Open Orders:
    • The product_ids parameter is no longer required. If not specified you get all products.
    • All other query params are currently non-functional and result in an error if used. This includes: order_type, cursor, limit, sort_direction, start_date, order_side, and end_date.
    • The maximum number of orders returned is 1000. If a client has more than 1000 open orders, an error is returned prompting the user to use WebSocket API, or FIX API to stream open orders.

2022-APR-07

  • Added the has_next boolean field to the pagination field in the response body. The has_next field indicates if there is more data available to paginate through.
  • Removed the total_result_count field has been removed from the pagination field in the response body.

2022-MAR-24

Added:
  • Create Withdrawal is now available to request new withdrawal transactions from a portfolio wallet.
  • Create Transfer is now available to request new transfers between portfolio wallets.

2022-MAR-19

Added:

2022-MAR-07

Added:

2022-FEB-15

Fixed:

2022-JAN-31

Added:

2022-JAN-19

Fixed: Additions:
  • The fields transfer_from and transfer_to now appear in the Transaction resource for withdrawals and deposits.
  • External address deposit information is now included in the Transaction resource response.

2022-JAN-15

Additions:
  • For deposits and withdrawals to bank accounts, the payment method associated with that bank account now appears in the Transaction response as the transfer_from and transfer_to type.
  • Added non-balance impacting transaction types to List Portfolio Transactions.

2021-DEC-15

  • Welcome to the Coinbase Prime REST API.