Coinbase

App · 24 actions

Work with your own Coinbase account: balances, transactions, receive addresses and sending crypto; trading pairs and prices; previewing, placing and canceling orders; fills, portfolios and fees; and converting between cash and stablecoins.

Actions

ActionWhat it does
Cancel ordersCancel one or more open orders.
ConvertCarry out a conversion quoted by 'Get conversion quote'.
Create receive addressMake a new address for receiving crypto into an account, such as one per customer or invoice.
Get accountGet one account and its balance, by its currency (such as BTC) or its id.
Get best bid and askGet the highest bid and lowest ask, as numbers, for one or more pairs, with the spread between them.
Get conversionGet a conversion or quote with its status, amounts, rate and fee.
Get conversion quoteQuote converting between cash and a stablecoin, such as USD to USDC.
Get fees and volumeGet your trading fee tier, maker and taker fee rates, the fees you've paid and your trading volume.
Get key permissionsCheck what the connected API key may do (view, trade, transfer) and which portfolio it is limited to.
Get orderGet one order with its status, how much has filled, the average price and fees.
Get portfolio holdingsGet a portfolio's total value and each asset it holds, with what each is worth and its share of the whole.
Get trading pairGet one pair's price, 24 hour change, smallest and largest order, and whether it is trading.
Get transactionGet one transaction with its status, amounts and blockchain details.
List accountsList your Coinbase accounts, one per currency, with their balances.
List fillsList the trades your orders filled in, newest first, with the price, size and fee of each.
List ordersList your Advanced Trade orders, newest first, by pair, status, side and time.
List payment methodsList the bank accounts and cards linked to your Coinbase account.
List portfoliosList the portfolios the API key can see.
List receive addressesList the addresses an account can receive crypto at, newest first.
List trading pairsList the pairs you can trade, busiest first, with their prices and order size limits.
List transactionsList an account's transactions, newest first: crypto received and sent, buys, sells, conversions, deposits and more.
Place orderBuy or sell at the market price, or at your limit price.
Preview orderSee what an order would cost, its fees, and whether Coinbase would accept it, without placing it.
Send cryptoSend crypto from an account to a crypto address or an email address.

Cancel orders

Cancel one or more open orders. Each comes back saying whether it was canceled, and why not (such as already filled).

Inputs

Order IDsorder_idslistRequired
The ids of the orders to cancel, from 'List orders' or 'Place order'.

Outputs

canceled_countnumber
How many were canceled
failed_countnumber
How many weren't
resultslist
One entry per order
Example output
{
  "canceled_count": 1,
  "failed_count": 0,
  "results": [
    {
      "failure_reason": "",
      "order_id": "0000-000000-000000",
      "success": true
    }
  ]
}

Convert

Carry out a conversion quoted by 'Get conversion quote'. This moves real money.

Inputs

Quote IDtrade_idtextRequired
The trade_id from 'Get conversion quote'.
Fromfrom_currencytextRequired
The currency to convert from.One of: USD (US dollar (USD)), USDC (USD Coin (USDC)), PYUSD (PayPal USD (PYUSD)), EUR (Euro (EUR)), EURC (Euro Coin (EURC)).
Toto_currencytextRequired
The currency to convert to.One of: USD (US dollar (USD)), USDC (USD Coin (USDC)), PYUSD (PayPal USD (PYUSD)), EUR (Euro (EUR)), EURC (Euro Coin (EURC)).

Outputs

statustext
TRADE_STATUS_CREATED for a quote, then STARTED, COMPLETED or CANCELED
tradeobject
A conversion or quote
trade_idtext
The conversion's id, for 'Convert' and 'Get conversion'
Example output
{
  "status": "TRADE_STATUS_STARTED",
  "trade": {
    "amount": {
      "currency": "USD",
      "value": "100"
    },
    "exchange_rate": {
      "currency": "USDC",
      "value": "1"
    },
    "id": "ffc2bb4e-4f8b-4a9e-9e3a-7d1c3b5e6f70",
    "source_currency": "USD",
    "status": "TRADE_STATUS_STARTED",
    "subtotal": {
      "currency": "USD",
      "value": "100"
    },
    "target_currency": "USDC",
    "total": {
      "currency": "USDC",
      "value": "100"
    },
    "total_fee": {
      "amount": {
        "currency": "USD",
        "value": "0"
      },
      "title": "Coinbase fee"
    },
    "user_entered_amount": {
      "currency": "USD",
      "value": "100"
    }
  },
  "trade_id": "ffc2bb4e-4f8b-4a9e-9e3a-7d1c3b5e6f70"
}

Create receive address

Make a new address for receiving crypto into an account, such as one per customer or invoice.

Inputs

AccountaccounttextRequired
The account, one per currency. Pick one, type its currency such as BTC, or give its id from 'List accounts'.
Labeladdress_nametext
Your own label for the address, such as an invoice number.
Networknetworktext
The blockchain, such as ethereum, base, solana or bitcoin. Leave empty for the currency's usual one.

Outputs

addressobject
A receive address
Example output
{
  "address": {
    "address": "0xc0ffee254729296a45a3885639AC7E10F9d54979",
    "created_at": "2026-10-20T09:12:44Z",
    "id": "dd3183eb-af1d-5f5d-a90d-cbff946435ff",
    "name": "Lodol",
    "network": "ethereum",
    "resource_path": "/v2/accounts/2bbf394c-193b-5b2a-9155-3b4732659ede/addresses/dd3183eb-af1d-5f5d-a90d-cbff946435ff"
  }
}

Get account

Get one account and its balance, by its currency (such as BTC) or its id.

Inputs

AccountaccounttextRequired
The account, one per currency. Pick one, type its currency such as BTC, or give its id from 'List accounts'.

Outputs

accountobject
A Coinbase account, which holds one currency
Example output
{
  "account": {
    "balance": {
      "amount": "0.01500000",
      "currency": "BTC"
    },
    "created_at": "2024-01-31T20:49:02Z",
    "currency": {
      "code": "BTC",
      "exponent": 8,
      "name": "Bitcoin",
      "type": "crypto"
    },
    "id": "2bbf394c-193b-5b2a-9155-3b4732659ede",
    "name": "BTC Wallet",
    "primary": true,
    "resource_path": "/v2/accounts/2bbf394c-193b-5b2a-9155-3b4732659ede",
    "type": "wallet",
    "updated_at": "2026-10-20T09:12:44Z"
  }
}

Get best bid and ask

Get the highest bid and lowest ask, as numbers, for one or more pairs, with the spread between them.

Inputs

Trading pairsproduct_idslistRequired
One or more pairs, such as BTC-USD and ETH-USD.

Outputs

countnumber
How many were returned
priceslist
One entry per pair
Example output
{
  "count": 1,
  "prices": [
    {
      "ask_size": 0.17,
      "best_ask": 68240.02,
      "best_bid": 68240.01,
      "bid_size": 0.42,
      "product_id": "BTC-USD",
      "spread": 0.01,
      "time": "2026-10-20T09:12:44Z"
    }
  ]
}

Get conversion

Get a conversion or quote with its status, amounts, rate and fee.

Inputs

Quote IDtrade_idtextRequired
The trade_id from 'Get conversion quote'.
Fromfrom_currencytextRequired
The currency to convert from.One of: USD (US dollar (USD)), USDC (USD Coin (USDC)), PYUSD (PayPal USD (PYUSD)), EUR (Euro (EUR)), EURC (Euro Coin (EURC)).
Toto_currencytextRequired
The currency to convert to.One of: USD (US dollar (USD)), USDC (USD Coin (USDC)), PYUSD (PayPal USD (PYUSD)), EUR (Euro (EUR)), EURC (Euro Coin (EURC)).

Outputs

statustext
TRADE_STATUS_CREATED for a quote, then STARTED, COMPLETED or CANCELED
tradeobject
A conversion or quote
trade_idtext
The conversion's id, for 'Convert' and 'Get conversion'
Example output
{
  "status": "TRADE_STATUS_COMPLETED",
  "trade": {
    "amount": {
      "currency": "USD",
      "value": "100"
    },
    "exchange_rate": {
      "currency": "USDC",
      "value": "1"
    },
    "id": "ffc2bb4e-4f8b-4a9e-9e3a-7d1c3b5e6f70",
    "source_currency": "USD",
    "status": "TRADE_STATUS_COMPLETED",
    "subtotal": {
      "currency": "USD",
      "value": "100"
    },
    "target_currency": "USDC",
    "total": {
      "currency": "USDC",
      "value": "100"
    },
    "total_fee": {
      "amount": {
        "currency": "USD",
        "value": "0"
      },
      "title": "Coinbase fee"
    },
    "user_entered_amount": {
      "currency": "USD",
      "value": "100"
    }
  },
  "trade_id": "ffc2bb4e-4f8b-4a9e-9e3a-7d1c3b5e6f70"
}

Get conversion quote

Quote converting between cash and a stablecoin, such as USD to USDC. Nothing moves until 'Convert' uses the quote.

Inputs

Fromfrom_currencytextRequired
The currency to convert from.One of: USD (US dollar (USD)), USDC (USD Coin (USDC)), PYUSD (PayPal USD (PYUSD)), EUR (Euro (EUR)), EURC (Euro Coin (EURC)).
Toto_currencytextRequired
The currency to convert to.One of: USD (US dollar (USD)), USDC (USD Coin (USDC)), PYUSD (PayPal USD (PYUSD)), EUR (Euro (EUR)), EURC (Euro Coin (EURC)).
AmountamountnumberRequired
How much to convert, in the From currency, such as 100.At least 0.

Outputs

statustext
TRADE_STATUS_CREATED for a quote, then STARTED, COMPLETED or CANCELED
tradeobject
A conversion or quote
trade_idtext
The conversion's id, for 'Convert' and 'Get conversion'
Example output
{
  "status": "TRADE_STATUS_CREATED",
  "trade": {
    "amount": {
      "currency": "USD",
      "value": "100"
    },
    "exchange_rate": {
      "currency": "USDC",
      "value": "1"
    },
    "id": "ffc2bb4e-4f8b-4a9e-9e3a-7d1c3b5e6f70",
    "source_currency": "USD",
    "status": "TRADE_STATUS_CREATED",
    "subtotal": {
      "currency": "USD",
      "value": "100"
    },
    "target_currency": "USDC",
    "total": {
      "currency": "USDC",
      "value": "100"
    },
    "total_fee": {
      "amount": {
        "currency": "USD",
        "value": "0"
      },
      "title": "Coinbase fee"
    },
    "user_entered_amount": {
      "currency": "USD",
      "value": "100"
    }
  },
  "trade_id": "ffc2bb4e-4f8b-4a9e-9e3a-7d1c3b5e6f70"
}

Get fees and volume

Get your trading fee tier, maker and taker fee rates, the fees you've paid and your trading volume.

Inputs

Kindproduct_typetext
Spot or futures trading. Leave empty for both.One of: SPOT (Spot (crypto pairs, the default)), FUTURE (Futures).

Outputs

maker_fee_ratenumber
The maker fee, such as 0.004 for 0.4%
pricing_tiertext
Your fee tier's name
summaryobject
Coinbase's whole answer, with the volume broken down
taker_fee_ratenumber
The taker fee, such as 0.006 for 0.6%
total_feesnumber
The fees you've paid over that time, in USD
total_volumenumber
Your trading volume over the last 30 days, in USD
Example output
{
  "maker_fee_rate": 0.004,
  "pricing_tier": "Advanced 1",
  "summary": {
    "fee_tier": {
      "maker_fee_rate": "0.004",
      "pricing_tier": "Advanced 1",
      "taker_fee_rate": "0.006"
    },
    "total_fees": 6,
    "total_volume": 1000
  },
  "taker_fee_rate": 0.006,
  "total_fees": 6.0,
  "total_volume": 1000.0
}

Get key permissions

Check what the connected API key may do (view, trade, transfer) and which portfolio it is limited to.

Inputs

None.

Outputs

can_tradetrue/false
True if the key can place orders and convert
can_transfertrue/false
True if the key can send crypto
can_viewtrue/false
True if the key can read the account
portfolio_typetext
That portfolio's type, such as DEFAULT
portfolio_uuidtext
The portfolio the key works in
Example output
{
  "can_trade": true,
  "can_transfer": false,
  "can_view": true,
  "portfolio_type": "DEFAULT",
  "portfolio_uuid": "8ff0ab7a-0d47-4ea6-9a3e-3b5f0b9f1c6e"
}

Get order

Get one order with its status, how much has filled, the average price and fees.

Inputs

Order IDorder_idtextRequired
The order's id, from 'Place order' or 'List orders'.

Outputs

orderobject
An order
Example output
{
  "order": {
    "average_filled_price": "68240.01",
    "cancel_message": "",
    "client_order_id": "11111-000000-000000",
    "completion_percentage": "100",
    "created_time": "2026-10-20T09:12:44Z",
    "filled_size": "0.00036631",
    "filled_value": "24.85",
    "last_fill_time": "2026-10-20T09:12:45Z",
    "number_of_fills": "1",
    "order_configuration": {
      "market_market_ioc": {
        "quote_size": "25"
      }
    },
    "order_id": "0000-000000-000000",
    "order_type": "MARKET",
    "product_id": "BTC-USD",
    "reject_reason": "",
    "side": "BUY",
    "status": "FILLED",
    "time_in_force": "IMMEDIATE_OR_CANCEL",
    "total_fees": "0.15",
    "total_value_after_fees": "25"
  }
}

Get portfolio holdings

Get a portfolio's total value and each asset it holds, with what each is worth and its share of the whole.

Inputs

Portfolioportfolio_idtextRequired
The portfolio. Pick one, or give its id from 'List portfolios'.
Value incurrencytext
The currency to value holdings in, such as USD or EUR.

Outputs

balancesobject
The portfolio's totals
countnumber
How many were returned
portfolioobject
A portfolio
spot_positionslist
What it holds
Example output
{
  "balances": {
    "total_balance": {
      "currency": "USD",
      "value": "1523.40"
    },
    "total_cash_equivalent_balance": {
      "currency": "USD",
      "value": "500.00"
    },
    "total_crypto_balance": {
      "currency": "USD",
      "value": "1023.40"
    }
  },
  "count": 1,
  "portfolio": {
    "deleted": false,
    "name": "Default",
    "type": "DEFAULT",
    "uuid": "8ff0ab7a-0d47-4ea6-9a3e-3b5f0b9f1c6e"
  },
  "spot_positions": [
    {
      "account_uuid": "2bbf394c-193b-5b2a-9155-3b4732659ede",
      "allocation": 0.67,
      "asset": "BTC",
      "available_to_trade_crypto": 0.015,
      "is_cash": false,
      "total_balance_crypto": 0.015,
      "total_balance_fiat": 1023.4
    }
  ]
}

Get trading pair

Get one pair's price, 24 hour change, smallest and largest order, and whether it is trading.

Inputs

Trading pairproduct_idtextRequired
The pair, such as BTC-USD: the coin, then the currency it is priced in.

Outputs

productobject
A trading pair
Example output
{
  "product": {
    "base_display_symbol": "BTC",
    "base_increment": "0.00000001",
    "base_max_size": "3400",
    "base_min_size": "0.00000001",
    "base_name": "Bitcoin",
    "cancel_only": false,
    "limit_only": false,
    "post_only": false,
    "price": "68240.01",
    "price_increment": "0.01",
    "price_percentage_change_24h": "1.82",
    "product_id": "BTC-USD",
    "product_type": "SPOT",
    "quote_display_symbol": "USD",
    "quote_increment": "0.01",
    "quote_max_size": "150000000",
    "quote_min_size": "1",
    "quote_name": "US Dollar",
    "status": "online",
    "trading_disabled": false,
    "volume_24h": "10512.4421"
  }
}

Get transaction

Get one transaction with its status, amounts and blockchain details. Use it to see whether a send has completed.

Inputs

AccountaccounttextRequired
The account, one per currency. Pick one, type its currency such as BTC, or give its id from 'List accounts'.
Transaction IDtransaction_idtextRequired
The transaction's id, from 'List transactions' or 'Send crypto'.

Outputs

transactionobject
A transaction on an account
Example output
{
  "transaction": {
    "advanced_trade_fill": null,
    "amount": {
      "amount": "0.00500000",
      "currency": "BTC"
    },
    "created_at": "2026-10-20T09:12:44Z",
    "description": null,
    "from": {
      "address": null,
      "email": null,
      "id": null,
      "resource": "bitcoin_network"
    },
    "id": "57ffb4ae-0c59-5430-bcd3-3f98f797a66c",
    "idem": null,
    "native_amount": {
      "amount": "341.20",
      "currency": "USD"
    },
    "network": {
      "hash": "a1b2c3d4e5f6",
      "network_name": "bitcoin",
      "status": "confirmed",
      "transaction_fee": null
    },
    "resource_path": "/v2/accounts/2bbf394c-193b-5b2a-9155-3b4732659ede/transactions/57ffb4ae-0c59-5430-bcd3-3f98f797a66c",
    "status": "completed",
    "to": null,
    "type": "receive"
  }
}

List accounts

List your Coinbase accounts, one per currency, with their balances. Only accounts holding something, unless you ask for the empty ones too.

Inputs

Include empty accountsinclude_emptytrue/false
Also list accounts with nothing in them.
How manylimitnumber
At most this many, newest first, 1 to 1000. Defaults to 1000.From 1 to 1000.

Outputs

accountslist
The accounts
countnumber
How many were returned
Example output
{
  "accounts": [
    {
      "balance": {
        "amount": "0.01500000",
        "currency": "BTC"
      },
      "created_at": "2024-01-31T20:49:02Z",
      "currency": {
        "code": "BTC",
        "exponent": 8,
        "name": "Bitcoin",
        "type": "crypto"
      },
      "id": "2bbf394c-193b-5b2a-9155-3b4732659ede",
      "name": "BTC Wallet",
      "primary": true,
      "resource_path": "/v2/accounts/2bbf394c-193b-5b2a-9155-3b4732659ede",
      "type": "wallet",
      "updated_at": "2026-10-20T09:12:44Z"
    }
  ],
  "count": 1
}

List fills

List the trades your orders filled in, newest first, with the price, size and fee of each.

Inputs

Order IDorder_idtext
Only this order's fills. Leave empty for every order.
Trading pairproduct_idtext
Only this pair, such as BTC-USD. Leave empty for every pair.
Fromstart_timedate and time
Only those from this time on.
Untilend_timedate and time
Only those before this time.
How manylimitnumber
At most this many, newest first, 1 to 300. Defaults to 25.From 1 to 300.

Outputs

countnumber
How many were returned
fillslist
The fills
Example output
{
  "count": 1,
  "fills": [
    {
      "commission": "0.15",
      "entry_id": "22222-2222222-22222222",
      "liquidity_indicator": "TAKER",
      "order_id": "0000-000000-000000",
      "price": "68240.01",
      "product_id": "BTC-USD",
      "side": "BUY",
      "size": "0.00036631",
      "size_in_quote": false,
      "trade_id": "1111-11111-111111",
      "trade_time": "2026-10-20T09:12:45Z"
    }
  ]
}

List orders

List your Advanced Trade orders, newest first, by pair, status, side and time.

Inputs

Trading pairproduct_idtext
Only this pair, such as BTC-USD. Leave empty for every pair.
Statusorder_statustext
Only orders in this state. Leave empty for every state.One of: OPEN, FILLED, CANCELLED (Canceled), EXPIRED, FAILED, PENDING.
Buy or sellsidetext
Only buys or only sells. Leave empty for both.One of: BUY, SELL.
Fromstart_timedate and time
Only those from this time on.
Untilend_timedate and time
Only those before this time.
How manylimitnumber
At most this many, newest first, 1 to 300. Defaults to 25.From 1 to 300.

Outputs

countnumber
How many were returned
orderslist
The orders
Example output
{
  "count": 1,
  "orders": [
    {
      "average_filled_price": "68240.01",
      "cancel_message": "",
      "client_order_id": "11111-000000-000000",
      "completion_percentage": "100",
      "created_time": "2026-10-20T09:12:44Z",
      "filled_size": "0.00036631",
      "filled_value": "24.85",
      "last_fill_time": "2026-10-20T09:12:45Z",
      "number_of_fills": "1",
      "order_configuration": {
        "market_market_ioc": {
          "quote_size": "25"
        }
      },
      "order_id": "0000-000000-000000",
      "order_type": "MARKET",
      "product_id": "BTC-USD",
      "reject_reason": "",
      "side": "BUY",
      "status": "FILLED",
      "time_in_force": "IMMEDIATE_OR_CANCEL",
      "total_fees": "0.15",
      "total_value_after_fees": "25"
    }
  ]
}

List payment methods

List the bank accounts and cards linked to your Coinbase account.

Inputs

None.

Outputs

countnumber
How many were returned
payment_methodslist
The payment methods
Example output
{
  "count": 1,
  "payment_methods": [
    {
      "allow_buy": true,
      "allow_deposit": true,
      "allow_sell": true,
      "allow_withdraw": true,
      "created_at": "2025-03-01T12:00:00Z",
      "currency": "USD",
      "id": "8bfc20d7-f7c6-4422-bf07-8243ca4169fe",
      "name": "Bank of America ******1234",
      "type": "ACH",
      "verified": true
    }
  ]
}

List portfolios

List the portfolios the API key can see.

Inputs

None.

Outputs

countnumber
How many were returned
portfolioslist
The portfolios
Example output
{
  "count": 1,
  "portfolios": [
    {
      "deleted": false,
      "name": "Default",
      "type": "DEFAULT",
      "uuid": "8ff0ab7a-0d47-4ea6-9a3e-3b5f0b9f1c6e"
    }
  ]
}

List receive addresses

List the addresses an account can receive crypto at, newest first.

Inputs

AccountaccounttextRequired
The account, one per currency. Pick one, type its currency such as BTC, or give its id from 'List accounts'.
How manylimitnumber
At most this many, newest first, 1 to 300. Defaults to 25.From 1 to 300.

Outputs

account_idtext
The account's id
addresseslist
The addresses
countnumber
How many were returned
Example output
{
  "account_id": "2bbf394c-193b-5b2a-9155-3b4732659ede",
  "addresses": [
    {
      "address": "0xc0ffee254729296a45a3885639AC7E10F9d54979",
      "created_at": "2026-10-20T09:12:44Z",
      "id": "dd3183eb-af1d-5f5d-a90d-cbff946435ff",
      "name": "Lodol",
      "network": "ethereum",
      "resource_path": "/v2/accounts/2bbf394c-193b-5b2a-9155-3b4732659ede/addresses/dd3183eb-af1d-5f5d-a90d-cbff946435ff"
    }
  ],
  "count": 1
}

List trading pairs

List the pairs you can trade, busiest first, with their prices and order size limits. Narrow it to one currency, such as BTC.

Inputs

Currencycurrencytext
Only pairs with this currency on either side, such as BTC or USD.
Kindproduct_typetext
Spot pairs or futures. Defaults to spot.One of: SPOT (Spot (crypto pairs, the default)), FUTURE (Futures).
How manylimitnumber
At most this many, newest first, 1 to 1000. Defaults to 50.From 1 to 1000.

Outputs

countnumber
How many were returned
productslist
The trading pairs
Example output
{
  "count": 1,
  "products": [
    {
      "base_display_symbol": "BTC",
      "base_increment": "0.00000001",
      "base_max_size": "3400",
      "base_min_size": "0.00000001",
      "base_name": "Bitcoin",
      "cancel_only": false,
      "limit_only": false,
      "post_only": false,
      "price": "68240.01",
      "price_increment": "0.01",
      "price_percentage_change_24h": "1.82",
      "product_id": "BTC-USD",
      "product_type": "SPOT",
      "quote_display_symbol": "USD",
      "quote_increment": "0.01",
      "quote_max_size": "150000000",
      "quote_min_size": "1",
      "quote_name": "US Dollar",
      "status": "online",
      "trading_disabled": false,
      "volume_24h": "10512.4421"
    }
  ]
}

List transactions

List an account's transactions, newest first: crypto received and sent, buys, sells, conversions, deposits and more.

Inputs

AccountaccounttextRequired
The account, one per currency. Pick one, type its currency such as BTC, or give its id from 'List accounts'.
Typetransaction_typetext
Only this kind. Leave empty for every kind.One of: receive (Received crypto), send (Sent crypto), buy (Bought), sell (Sold), advanced_trade_fill (Advanced Trade fill), trade (Converted), fiat_deposit (Cash deposit), fiat_withdrawal (Cash withdrawal), transfer (Moved between your accounts), staking_transfer (Moved to staking), and 3 more.
How manylimitnumber
At most this many, newest first, 1 to 300. Defaults to 25.From 1 to 300.

Outputs

account_idtext
The account's id
countnumber
How many were returned
transactionslist
The transactions
Example output
{
  "account_id": "2bbf394c-193b-5b2a-9155-3b4732659ede",
  "count": 1,
  "transactions": [
    {
      "advanced_trade_fill": null,
      "amount": {
        "amount": "0.00500000",
        "currency": "BTC"
      },
      "created_at": "2026-10-20T09:12:44Z",
      "description": null,
      "from": {
        "address": null,
        "email": null,
        "id": null,
        "resource": "bitcoin_network"
      },
      "id": "57ffb4ae-0c59-5430-bcd3-3f98f797a66c",
      "idem": null,
      "native_amount": {
        "amount": "341.20",
        "currency": "USD"
      },
      "network": {
        "hash": "a1b2c3d4e5f6",
        "network_name": "bitcoin",
        "status": "confirmed",
        "transaction_fee": null
      },
      "resource_path": "/v2/accounts/2bbf394c-193b-5b2a-9155-3b4732659ede/transactions/57ffb4ae-0c59-5430-bcd3-3f98f797a66c",
      "status": "completed",
      "to": null,
      "type": "receive"
    }
  ]
}

Place order

Buy or sell at the market price, or at your limit price. This trades with real money. Needs a key with Trade permission.

Inputs

Trading pairproduct_idtextRequired
The pair, such as BTC-USD: the coin, then the currency it is priced in.
Buy or sellsidetextRequired
Buy the coin, or sell it.One of: BUY, SELL.
Order typeorder_typetextRequired
Market fills now at the best price; limit waits for your price or better.One of: market (Market (at the best price now)), limit (Limit (at your price or better)).
AmountamountnumberRequired
How much, as a plain number such as 25 or 0.001.At least 0.
Amount is inamount_intextRequired
Whether the amount is money (such as 25 USD of BTC) or coins (such as 0.001 BTC).One of: quote (Money: the second currency, such as USD in BTC-USD), base (Coins: the first currency, such as BTC in BTC-USD).
Limit pricelimit_pricenumber
For a limit order: the most you'll pay for one coin when buying, or the least you'll take when selling, in the pricing currency.At least 0.
Cancel if not filled byend_timedate and time
For a limit order: when to cancel it if it hasn't filled. Leave empty to keep it until it fills or you cancel it.
Post onlypost_onlytrue/false
For a limit order: refuse it if it would fill at once, so it only ever waits on the order book (and pays the lower maker fee).

Outputs

client_order_idtext
The reference the order was placed with
order_configurationobject
How the order was set up: one key, market_market_ioc, limit_limit_gtc or limit_limit_gtd, holding its quote_size or base_size, and for a limit order its limit_price, post_only and end_time
order_idtext
The new order's id
product_idtext
The pair, such as BTC-USD
sidetext
BUY or SELL
Example output
{
  "client_order_id": "11111-000000-000000",
  "order_configuration": {
    "market_market_ioc": {
      "quote_size": "25"
    }
  },
  "order_id": "0000-000000-000000",
  "product_id": "BTC-USD",
  "side": "BUY"
}

Preview order

See what an order would cost, its fees, and whether Coinbase would accept it, without placing it.

Inputs

Trading pairproduct_idtextRequired
The pair, such as BTC-USD: the coin, then the currency it is priced in.
Buy or sellsidetextRequired
Buy the coin, or sell it.One of: BUY, SELL.
Order typeorder_typetextRequired
Market fills now at the best price; limit waits for your price or better.One of: market (Market (at the best price now)), limit (Limit (at your price or better)).
AmountamountnumberRequired
How much, as a plain number such as 25 or 0.001.At least 0.
Amount is inamount_intextRequired
Whether the amount is money (such as 25 USD of BTC) or coins (such as 0.001 BTC).One of: quote (Money: the second currency, such as USD in BTC-USD), base (Coins: the first currency, such as BTC in BTC-USD).
Limit pricelimit_pricenumber
For a limit order: the most you'll pay for one coin when buying, or the least you'll take when selling, in the pricing currency.At least 0.
Cancel if not filled byend_timedate and time
For a limit order: when to cancel it if it hasn't filled. Leave empty to keep it until it fills or you cancel it.
Post onlypost_onlytrue/false
For a limit order: refuse it if it would fill at once, so it only ever waits on the order book (and pays the lower maker fee).

Outputs

base_sizenumber
The amount in coins
best_asknumber
The lowest ask now
best_bidnumber
The highest bid now
commission_totalnumber
The fees
errorslist
Why Coinbase would refuse it, such as PREVIEW_INSUFFICIENT_FUND
est_average_filled_pricenumber
The average price it would likely fill at
oktrue/false
True when Coinbase would accept the order as it stands
order_totalnumber
What the order would cost or bring in, with fees
preview_idtext
The preview's id
quote_sizenumber
The amount in money
warningslist
Warnings, such as BIG_ORDER
Example output
{
  "base_size": 0.00036414,
  "best_ask": 68240.02,
  "best_bid": 68240.01,
  "commission_total": 0.15,
  "errors": [],
  "est_average_filled_price": 68240.02,
  "ok": true,
  "order_total": 25.0,
  "preview_id": "b40bbff9-17ce-4726-8b64-9de7ae57ad26",
  "quote_size": 24.85,
  "warnings": []
}

Send crypto

Send crypto from an account to a crypto address or an email address. This moves real money and can't be undone; Coinbase may hold it as pending first. Needs a key with Transfer permission.

Inputs

AccountaccounttextRequired
The account, one per currency. Pick one, type its currency such as BTC, or give its id from 'List accounts'.
TototextRequired
The crypto address, or the email address of a Coinbase user.
AmountamountnumberRequired
How much to send, in the account's currency, such as 0.01.At least 0.
Networknetworktext
The blockchain to send on, such as ethereum, base or solana. Leave empty for the currency's usual one.
Destination tag or memodestination_tagtext
The tag or memo the recipient asked for, for currencies such as XRP or XLM.
Notedescriptiontext
A note for the recipient, sent with an email send.

Outputs

transactionobject
A transaction on an account
Example output
{
  "transaction": {
    "advanced_trade_fill": null,
    "amount": {
      "amount": "-0.00100000",
      "currency": "BTC"
    },
    "created_at": "2026-10-20T09:12:44Z",
    "description": null,
    "from": null,
    "id": "3c04e35e-8e5a-5ff1-9155-00675db4ac02",
    "idem": "df087dce-92a8-45cf-b112-60aad22c0976",
    "native_amount": {
      "amount": "-68.24",
      "currency": "USD"
    },
    "network": {
      "hash": null,
      "network_name": "bitcoin",
      "status": "pending",
      "transaction_fee": {
        "amount": "0.00001200",
        "currency": "BTC"
      }
    },
    "resource_path": "/v2/accounts/2bbf394c-193b-5b2a-9155-3b4732659ede/transactions/57ffb4ae-0c59-5430-bcd3-3f98f797a66c",
    "status": "pending",
    "to": {
      "address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
      "email": null,
      "id": null,
      "resource": "bitcoin_address"
    },
    "type": "send"
  }
}

On this page