Skip to main content
Coming soon. Advanced Trade is moving international derivatives from INTX onto a Deribit-powered gateway running on the Starbase platform.
Coinbase International Exchange and Deribit are coming together to create a unified, world-class derivatives platform. The exchange infrastructure behind your perpetuals trades is moving to a combined platform powered by Deribit and Starbase.

​
Migration to Deribit Global Derivatives trading

​
Who is this guide for:

  • These guides are for new or existing Coinbase retail clients/partners who want to trade Global Derivatives after cutover.
  • Existing Deribit clients can continue to use Deribit services and APIs as they do today.

​
What’s new for you:

  • 125+ perpetual contracts: Including equity and commodity perpetuals
  • Up to 50x maximum leverage
  • Deeper liquidity: Unified order books from a combined global user base
  • Starbase platform: Faster, more scalable, lower-latency execution
  • Options trading — Coming soon for eligible users

​
What’s changing

  • New API endpoints. Derivatives trading moves to a new Deribit-powered gateway. The protocol moves from REST to JSON-RPC 2.0, over HTTP or WebSocket. Hosts are on the API reference overview; protocol detail is in the Technical Guide.
  • New products. 125+ perpetual contracts at launch — including equity and commodity perpetuals — with up to 50x maximum leverage. Options and dated futures follow (see Timeline).
  • A richer trading surface. New native order types and features become available, including trailing stops, market-limit orders, iceberg orders, and WebSocket order entry.
  • More order controls. Choose your margin model per portfolio, trigger stop and take orders on the index, mark, or last price, and auto-cancel resting orders if your WebSocket connection drops (Cancel on Disconnect).

​
What’s not changing

  • Your API key. Keep your existing CDP API key. There are no new credentials to create, and the same key authenticates to the new gateway.
  • Spot trading. Spot API endpoints are unaffected and remain on api.coinbase.com.
  • Funding. You fund your derivatives account through Coinbase, as today — see Funding below.
  • Key management. API keys are still created and managed in the CDP Portal, as today.
This is a different protocol and order model. Some behaviours change — see Order types below. Plan integration time accordingly.

​
Migration Guides

The migration is covered in the 4 guides:

Overview

This guide covers the timeline, new products, order types, margin models, and the migration plan.

Technical Guide

The implementation reference: authentication, endpoint and schema mapping, and spec references.

Deribit Partners Guide

For registered Deribit partners — how the Coinbase integration affects an existing Deribit integration.

INTX Partners Guide

For partners on Coinbase’s international (INTX) platform moving to the new Deribit-backed service.

​
Timeline

This is a hard cutover. There is no parallel-running window — the old endpoints and the new gateway do not run side by side. Integrations not migrated by cutover stop trading.

​
What happens at cutover

Your positions and balances migrate automatically — but your open orders do not.
1

Open orders are cancelled

All resting orders on International Exchange are cancelled. Re-place them on the new gateway after the switch.
2

Positions are settled and recreated

Open positions settle at the mark price (PnL crystallized, funding paid), then are recreated at the settlement price on the new platform. Nothing for you to do.
3

Balances transfer

Your collateral moves to your account on the combined platform automatically.
You may see multiple trade records, a reset of your average entry price, and a small temporary PnL variance — these are standard migration artifacts. No trading or settlement fees are charged for the migration.

​
Funding

Funding stays on Coinbase. Only derivatives trading moves to the new gateway. Fund your derivatives portfolio in the same way via the UI or API before you place orders:
  • Retrieve the portfolio’s account ID with GET /api/v3/brokerage/portfolios
  • Transfer collateral with POST /api/v3/brokerage/portfolios/move_funds.

​
Margin models

You choose a margin model per portfolio, and the choice combines two independent settings.
  • Cross or segregated. Cross margin pools collateral across all your positions, so a gain on one cushions a loss on another. Segregated (isolated) margin ring-fences collateral to a single position, so a loss there can’t drain the rest of your account.
  • Portfolio or standard. Portfolio margin nets the risk of related positions and can lower your total requirement. Standard margin sizes each position’s requirement on its own, with no netting.
The four models combine these two settings: Set or change your model with private/change_margin_model.

​
Order types

Order-type and time-in-force values are renamed and lowercased. The take-profit / stop-loss model also changes shape.

​
Order type mapping

​
Time-in-force

​
Migration checklist

Detailed auth, endpoint, and schema specifics are in the Technical Guide. This is the action list:
1

Update base URLs and move to JSON-RPC 2.0

  • REST https://drb.coinbase.com/api/v2
  • WebSocket wss://drb.coinbase.com/ws/api/v2
Each request carries a method, parameters object, ID, and protocol version. Use REST for request-response, WebSocket for live event-driven flows.
2

Keep your CDP API keys but add the new token exchange

Call public/auth with grant_type: coinbase_cdp, then cache and refresh the access token before it expires.
3

Update instrument names

Perpetuals become {BASE}_USDC-PERPETUAL (for example, BTC-PERP-INTX → BTC_USDC-PERPETUAL). Discover exact names via public/get_instruments.
4

Fund your derivatives account

Confirm collateral is in place via Coinbase before you trade.
5

Send numeric values as numbers

Prices and sizes are JSON numbers in and out; amount units follow the instrument.
6

Update order-type and time-in-force values

Switch to the new lowercase names. There is no good-til-time equivalent; use good-til-day or handle expiry yourself.
7

Refactor take-profit / stop-loss to OTOCO

Replace the single combined order with two linked exit orders.
8

Deribit Advanced Trading gateway is live

Cutover is coming soon, no parallel run. Repoint production traffic.

​
FAQ

No. You keep your existing Coinbase (CDP) API key and authenticate to the new gateway with it. There is no separate account or key to create.
No. This is a hard cutover. Integrations not migrated by cutover stop trading.
Open orders are cancelled — re-place them on the new gateway after the switch. Positions and balances migrate automatically (settled and recreated on the new platform). See What happens at cutover.
No. Your spot integration is unchanged — spot API endpoints remain on api.coinbase.com. You can also place spot orders through the new gateway, which routes them to the same Coinbase Exchange order books. That path is optional and additive; there is nothing to migrate for spot.
Funding stays on Coinbase and is unchanged. See Funding above.
There is no good-til-time equivalent. Use good-til-day (expires at session end) or manage expiry client-side.
Expected. The engine issues a new order ID after the stop triggers. Track both IDs.
Expected. Rate-limit exhaustion disconnects you; it does not return a retryable HTTP 429. Implement credit-aware backoff.
Contact your Coinbase account manager.