Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cloud.coinbase.com/llms.txt

Use this file to discover all available pages before exploring further.

Trading on Coinbase International Exchange (INTX) is conducted through the Orders API. This guide covers order creation, management, modification, and cancellation workflows.

​
Creating an Order

Use Create Order to place trades. Each order requires an instrument, side, size, type, and time-in-force specification. 
import uuid
from intx_sdk import IntxServicesClient
from intx_sdk.services.orders import CreateOrderRequest
from intx_sdk.enums import OrderSide, OrderType, TimeInForce

client = IntxServicesClient.from_env()

request = CreateOrderRequest(
    portfolio="PORTFOLIO_ID_HERE",
    client_order_id=str(uuid.uuid4()),
    instrument="BTC-PERP",
    side=OrderSide.BUY.value,
    size="0.1",
    type=OrderType.LIMIT.value,
    price="50000",
    tif=TimeInForce.GTC.value
)

response = client.orders.create_order(request)
print(response)
To learn more about this SDK, please visit the INTX Python SDK.

​
Order Types

INTX supports multiple order types for different trading strategies:
Order TypeDescription
LIMITExecute at specified price or better
MARKETExecute immediately at best available price
STOPTrigger a market order when stop price is reached
STOP_LIMITTrigger a limit order when stop price is reached

​
Limit Order Example

request = CreateOrderRequest(
    portfolio="PORTFOLIO_ID_HERE",
    client_order_id=str(uuid.uuid4()),
    instrument="ETH-PERP",
    side=OrderSide.BUY.value,
    size="1.0",
    type=OrderType.LIMIT.value,
    price="3000",
    tif=TimeInForce.GTC.value
)

response = client.orders.create_order(request)

​
Market Order Example

request = CreateOrderRequest(
    portfolio="PORTFOLIO_ID_HERE",
    client_order_id=str(uuid.uuid4()),
    instrument="ETH-PERP",
    side=OrderSide.SELL.value,
    size="1.5",
    type=OrderType.MARKET.value,
    tif=TimeInForce.IOC.value
)

response = client.orders.create_order(request)

​
Stop-Limit Order Example

request = CreateOrderRequest(
    portfolio="PORTFOLIO_ID_HERE",
    client_order_id=str(uuid.uuid4()),
    instrument="BTC-PERP",
    side=OrderSide.SELL.value,
    size="0.5",
    type=OrderType.STOP_LIMIT.value,
    stop_price="48000",
    stop_limit_price="47500",
    tif=TimeInForce.GTC.value
)

response = client.orders.create_order(request)

​
Listing Open Orders

Retrieve active orders using List Open Orders. Orders can be filtered by instrument, side, order type, and other parameters. 
from intx_sdk import IntxServicesClient
from intx_sdk.services.orders import ListOpenOrdersRequest

client = IntxServicesClient.from_env()

request = ListOpenOrdersRequest(
    portfolio="PORTFOLIO_ID_HERE"
)

response = client.orders.list_open_orders(request)
print(response)

​
Getting Order Details

Retrieve details for a specific order using Get Order Details. 
from intx_sdk import IntxServicesClient
from intx_sdk.services.orders import GetOrderDetailsRequest

client = IntxServicesClient.from_env()

request = GetOrderDetailsRequest(
    portfolio="PORTFOLIO_ID_HERE",
    order_id="your-order-id"
)

response = client.orders.get_order_details(request)
print(response)

​
Modifying an Order

Modify open orders using Modify Open Order. You can adjust price, stop price, or size without cancelling and recreating the order. 
import uuid
from intx_sdk import IntxServicesClient
from intx_sdk.services.orders import ModifyOpenOrderRequest

client = IntxServicesClient.from_env()

request = ModifyOpenOrderRequest(
    portfolio="PORTFOLIO_ID_HERE",
    id="your-order-id",
    client_order_id=str(uuid.uuid4()),
    price="51000"
)

response = client.orders.modify_open_order(request)
print(response)

​
Cancelling an Order

Cancel a single order using Cancel Order. 
from intx_sdk import IntxServicesClient
from intx_sdk.services.orders import CancelOrderRequest

client = IntxServicesClient.from_env()

request = CancelOrderRequest(
    portfolio="PORTFOLIO_ID_HERE",
    id="your-order-id"
)

response = client.orders.cancel_order(request)
print(response)

​
Cancelling Multiple Orders

Cancel multiple orders at once using Cancel Orders. This can cancel all orders or filter by instrument, side, or type. 
from intx_sdk import IntxServicesClient
from intx_sdk.services.orders import CancelOrdersRequest
from intx_sdk.enums import OrderSide

client = IntxServicesClient.from_env()

# Cancel all BUY orders for BTC-PERP
request = CancelOrdersRequest(
    portfolio="PORTFOLIO_ID_HERE",
    instrument="BTC-PERP",
    side=OrderSide.BUY.value
)

response = client.orders.cancel_orders(request)
print(response)