Skip to content

International Exchange (legacy) ​

CBInternationalClient retains the old api.international.coinbase.com routes. Coinbase's institutional migration FAQ says accounts, positions and balances migrated to Deribit on 1 October 2026. The migrated INTX accounts are view-only and the old API endpoints no longer support trading.

Institutional trading now uses the Deribit API and new Deribit API keys. The Advanced Trade Global client connects to Coinbase’s retail gateway, not the institutional Deribit API.

SDK scope ​

The examples below document legacy INTX integrations, which use INTX instruments, portfolio IDs and credentials. A Deribit integration requires its own API keys and request formats.

Legacy market data ​

The public REST example shows how the SDK constructs requests:

ts
// Legacy INTX example. Institutional trading migrated to Deribit on 1 October 2026.
// Retained SDK routes do not guarantee current endpoint or feed availability.
import { CBInternationalClient } from 'coinbase-api';

async function main() {
  const client = new CBInternationalClient();
  const instruments = await client.getInstruments();
  console.log(instruments);
}

main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});

The legacy market-data methods are getInstruments(), getInstrumentDetails() and getQuotePerInstrument(). For current market data, use the Deribit API.

Legacy authentication ​

The SDK's INTX authentication uses an API key, secret and passphrase. Historical public REST discovery did not require credentials, but INTX market WebSocket subscriptions did. Do not reuse these API keys with the replacement venue.

Legacy market subscriptions ​

The example subscribes to LEVEL1 on the SDK's internationalMarketData connection:

ts
// Legacy INTX example. Institutional trading migrated to Deribit on 1 October 2026.
// Retained SDK routes do not guarantee current endpoint or feed availability.
import { WebsocketClient, WS_KEY_MAP } from 'coinbase-api';

function requiredEnvVar(name: string) {
  const value = process.env[name];
  if (!value) {
    throw new Error(`Set ${name}.`);
  }
  return value;
}

const ws = new WebsocketClient({
  apiKey: requiredEnvVar('COINBASE_INTX_API_KEY'),
  apiSecret: requiredEnvVar('COINBASE_INTX_API_SECRET'),
  apiPassphrase: requiredEnvVar('COINBASE_INTX_API_PASSPHRASE'),
});

ws.on('update', (event) => {
  console.log(event);
});
ws.on('response', (event) => {
  console.log(event);
});
ws.on('exception', (error) => {
  console.error(error);
});
ws.on('reconnect', (event) => {
  console.log(event);
});
ws.on('reconnected', (event) => {
  console.log(event);
});

ws.subscribe(
  { topic: 'LEVEL1', payload: { product_ids: ['BTC-PERP'] } },
  WS_KEY_MAP.internationalMarketData,
);

function stop() {
  ws.closeAll();
}
process.once('SIGINT', stop);
process.once('SIGTERM', stop);

The SDK signs subscription requests for the legacy market-data URL wss://ws-md.international.coinbase.com. This subscription is for market data, not portfolio or order updates.

Historical records ​

Coinbase says historical INTX trade and order data will remain accessible for approximately 12 months after migration. INTX history does not appear in Deribit. Export the records you need within that retention period.

The account example shows portfolio-scoped reads:

ts
// Legacy INTX example. Institutional trading migrated to Deribit on 1 October 2026.
// Retained SDK routes do not guarantee current endpoint or feed availability.
import { CBInternationalClient } from 'coinbase-api';

function requiredEnvVar(name: string) {
  const value = process.env[name];
  if (!value) {
    throw new Error(`Set ${name}.`);
  }
  return value;
}

async function main() {
  const client = new CBInternationalClient({
    apiKey: requiredEnvVar('COINBASE_INTX_API_KEY'),
    apiSecret: requiredEnvVar('COINBASE_INTX_API_SECRET'),
    apiPassphrase: requiredEnvVar('COINBASE_INTX_API_PASSPHRASE'),
  });
  const portfolio = requiredEnvVar('COINBASE_INTX_PORTFOLIO');
  console.log(await client.getPortfolioBalances({ portfolio }));
  console.log(await client.getPortfolioPositions({ portfolio }));
  console.log(await client.getOpenOrders({ portfolio }));
}

main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});

getOrderDetails() and getPortfolioFills() are the SDK’s legacy order and fill queries. Keep the INTX portfolio identifier with each historical record and paginate the results.

Retired trading ​

Do not use submitOrder(), updateOpenOrder() or the cancellation methods as a new INTX trading integration. Coinbase states that old INTX endpoints no longer support trading. Margin loans did not migrate.

Legacy environments ​

useSandbox: true selects the legacy INTX sandbox hosts. For Deribit development, use Deribit’s test environment and API keys.

Legacy INTX client reference · Institutional migration FAQ · Choose another API

Built by Siebly. Open source SDKs for exchange APIs.