GuidesAPI Reference
DocumentationLog In

Changelog

2022-MAY-05

  • Added cancel reason to the FIX and websocket feeds.
  • For FIX, we enhanced the Execution Report to include the cancel reason using the Text field.
  • For the websocket feed, we added a new cancel_reason field for authenticated messages by the user, accessible in the Full and User channels.

Supported cancel reasons are:

101:Time In Force
102:Self Trade Prevention
103:Admin
104:Price Bound Order Protection
105:Insufficient Funds"
106:Insufficient Liquidity
107:Broker

2022-APR-14

  • Updated the maximum number of portfolios (or profiles) to 25.

2022-MAR-21

  • Updated the maximum number of portfolios (or profiles) to 15.

2022-MAR-17

  • Added FIX message tags: cumQty, leaveQty, AvgPx

2022-FEB-22

  • REST API will enforce case sensitivity for all URLs.
    • Example: https://api.exchange.coinbase.com/products/BTC-USD/Ticker should be https://api.exchange.coinbase.com/products/BTC-USD/ticker. Note the lowercase t in ticker.
    • This does not apply to URL parameters, just the URL itself: https://api.exchange.coinbase.com/orders?product_id=BTC-USD&sortedBy=created_at&sorting=desc&limit=100 is valid as the the URL is lowercase. Query parameters such as product_id can have values with capitals. However https://api.exchange.coinbase.com/Orders?product_id=BTC-USD&sortedBy=created_at&sorting=desc&limit=100 would be invalid as the O in /Orders is not the same URL as specified in its docs.

2022-JAN-31

  • Web Socket API users are notified when the client is actively disconnected for having a full buffer, or for being too slow to consume or read messages.

2022-JAN-25

  • GET and POST responses for the /orders endpoint will return client order id as client_oid if exists.

2021-OCT-25

  • FIX API will now enforce CheckSum validations for incoming FIX messages.

2021-SEP-21

  • All reports can be generated in parallel. Clients are no longer restricted to only have 3 reports being created at a time. Now clients can have up to 3 accounts reports and 3 fills reports per product generating at a time.

2021-SEP-09

  • Return the full aggregated order book for Level 2 queries under the GET /products/<product-id>/book endpoint.

2021-AUG-23

  • Reduced the set of fields returned by orders in "pending" status for GET /orders, GET /orders/<id>, and GET /orders/client:<client_oid> APIs. See List Orders documentation for more details. Orders with non-pending statuses will be unaffected by this change.

2021-AUG-17

  • Return client order ID rather than order ID in successful cancel order response for REST API endpoint DELETE /orders/client:<client_oid>.

2021-AUG-12

  • Require the field Symbol(55) on the following FIX API messages: OrderCancelRequeset(F) and OrderStatusRequest(H). Messages (F) and (H) without Symbol(55) will be rejected.

2021-AUG-06

  • Add pagination support for the GET /fills endpoint.

2021-AUG-01

  • Increased the maximum number of FIX connections allowed per profile from 5 to 7.

2021-JUL-01

  • Added sendingTime 5 minute validation.

2021-JUN-22

  • Added fx_stablecoin to products.

2021-JUN-21

  • Order Cancel Batch Request(U4) will accept optional ClOrdID(11) field for each cancel request. The provided ClOrdID(11) will be included in Order Cancel Reject(9) for partial reject.

2021-JUN-14

  • Order Cancel Batch Request(U4) will now return Order Cancel Reject(9) for partial rejected cancel request.

2021-JUN-10

  • Added failed status to reports.

2021-JUN-03

  • Our API endpoints were moved to exchange.coinbase.com from prime.coinbase.com.

Production URLs

ProductOld URLNew URL
Websitehttps://prime.coinbase.comhttps://exchange.coinbase.com
REST APIhttps://api.prime.coinbase.comhttps://api.exchange.coinbase.com
FIX APItcp+ssl://fix.prime.coinbase.com:4198tcp+ssl://fix.exchange.coinbase.com:4198
Web Socket APIwss://ws-feed.prime.coinbase.comwss://ws-feed.exchange.coinbase.com

Sandbox URLs

ProductOld URLNew URL
Websitehttps://public.sandbox.prime.coinbase.comhttps://public.sandbox.exchange.coinbase.com
REST APIhttps://api-public.sandbox.prime.coinbase.comhttps://api-public.sandbox.exchange.coinbase.com
FIX APItcp+ssl://fix-public.sandbox.prime.coinbase.com:4198tcp+ssl://fix-public.sandbox.exchange.coinbase.com:4198
Web Socket APIwss://ws-feed-public.sandbox.prime.coinbase.comwss://ws-feed-public.sandbox.exchange.coinbase.com

2021-MAY-27

  • API FIX - Order Cancel Request (F) endpoint requires the Symbol field now.

2021-MAY-20

  • /fills custom rate limit.

2021-MAY-14

  • Increased public and private rate limits.

2021-APR-22

  • Increase pagination limit from 100 to 1000.

2021-APR-05

  • Updated max profiles to 10 and max API keys to 200.

2021-FEB-04

  • The Trailing Volume endpoint has been deprecated in favor of the Fees endpoint to get the latest volumes.

2021-JAN-15

  • Now recommending that clients opt to batch cancel orders by profile rather than session due to recent performance optimizations.

2020-DEC-23

  • HandlInst in API FIX is no longer required.

2020-NOV-16

  • Addition of max_withdrawal_amount field in the /currencies endpoint.

2020-OCT-05

  • Authed users subscribed to the Websocket Full or User channel will now receive their order fee rates on match messages. Details can be found in documentation for the Full channel.

2020-OCT-02

  • Addition of cancel_code field on canceled withdrawals.

2020-SEP-17

  • Addition of an endpoint to provide estimates of network fees for crypto withdrawals.
  • Addition of a parameter for crypto withdrawals to specify if the network fee should be added / deducted from the requested amount.
  • 'fee' and 'subtotal' fields added to responses for crypto withdrawals.

2020-SEP-14

  • The candles endpoint no longer has custom rate limits. It now shares the same rate limit with every other public endpoint.

2020-SEP-03

  • The maximum number of open orders (i.e. limit orders + stop orders) per product per profile will be 500. Profiles that exceed this threshold will be unable to place new orders on that product until the number of open orders is below 500.

2020-JUN-18

2020-JUN-17

  • Generate an address for crypto deposits. See reference here.

2020-JUN-15

  • Expose min_market_funds, max_market_funds fields in the /products endpoint.

2020-JUN-12

  • Users can retrieve information regarding their transfer, buy, and sell limits at /users/self/exchange-limits. Refer to the Limits API for more information.

2020-APR-27

  • Fill execution reports will show fee rates associated with the user's order. Please refer to the FIX ExecutionReport API for details on format.

2020-FEB-20

  • Execution Reports from Order Status Requests will return ClOrdID, if it is supplied, even if the order isn't found.

2020-FEB-10

  • Activate messages on the Websocket feed will no longer expose taker_fee_rate.

2019-DEC-16

  • Rate limiting changing from a per user basis to per profile basis.

2019-SEP-30

  • Order Status Request no longer allows the wildcard option.
  • Order Status Request returns pending and done orders when you use OrderID or ClOrdID.
  • Scheduled disconnects are on Mondays and Thursdays at 11 AM Pacific Time.