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
| Action | What it does |
|---|---|
| Cancel orders | Cancel one or more open orders. |
| Convert | Carry out a conversion quoted by 'Get conversion quote'. |
| Create receive address | Make a new address for receiving crypto into an account, such as one per customer or invoice. |
| Get account | Get one account and its balance, by its currency (such as BTC) or its id. |
| Get best bid and ask | Get the highest bid and lowest ask, as numbers, for one or more pairs, with the spread between them. |
| Get conversion | Get a conversion or quote with its status, amounts, rate and fee. |
| Get conversion quote | Quote converting between cash and a stablecoin, such as USD to USDC. |
| Get fees and volume | Get your trading fee tier, maker and taker fee rates, the fees you've paid and your trading volume. |
| Get key permissions | Check what the connected API key may do (view, trade, transfer) and which portfolio it is limited to. |
| Get order | Get one order with its status, how much has filled, the average price and fees. |
| 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. |
| Get trading pair | Get one pair's price, 24 hour change, smallest and largest order, and whether it is trading. |
| Get transaction | Get one transaction with its status, amounts and blockchain details. |
| List accounts | List your Coinbase accounts, one per currency, with their balances. |
| List fills | List the trades your orders filled in, newest first, with the price, size and fee of each. |
| List orders | List your Advanced Trade orders, newest first, by pair, status, side and time. |
| List payment methods | List the bank accounts and cards linked to your Coinbase account. |
| List portfolios | List the portfolios the API key can see. |
| List receive addresses | List the addresses an account can receive crypto at, newest first. |
| List trading pairs | List the pairs you can trade, busiest first, with their prices and order size limits. |
| List transactions | List an account's transactions, newest first: crypto received and sent, buys, sells, conversions, deposits and more. |
| Place order | Buy or sell at the market price, or at your limit price. |
| Preview order | See what an order would cost, its fees, and whether Coinbase would accept it, without placing it. |
| Send crypto | Send 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 IDs
order_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 ID
trade_idtextRequired - The trade_id from 'Get conversion quote'.
- From
from_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)). - To
to_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
- Account
accounttextRequired - The account, one per currency. Pick one, type its currency such as BTC, or give its id from 'List accounts'.
- Label
address_nametext - Your own label for the address, such as an invoice number.
- Network
networktext - 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
- Account
accounttextRequired - 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 pairs
product_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 ID
trade_idtextRequired - The trade_id from 'Get conversion quote'.
- From
from_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)). - To
to_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
- From
from_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)). - To
to_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)). - Amount
amountnumberRequired - 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
- Kind
product_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 ID
order_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
- Portfolio
portfolio_idtextRequired - The portfolio. Pick one, or give its id from 'List portfolios'.
- Value in
currencytext - 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 pair
product_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
- Account
accounttextRequired - The account, one per currency. Pick one, type its currency such as BTC, or give its id from 'List accounts'.
- Transaction ID
transaction_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 accounts
include_emptytrue/false - Also list accounts with nothing in them.
- How many
limitnumber - 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 ID
order_idtext - Only this order's fills. Leave empty for every order.
- Trading pair
product_idtext - Only this pair, such as BTC-USD. Leave empty for every pair.
- From
start_timedate and time - Only those from this time on.
- Until
end_timedate and time - Only those before this time.
- How many
limitnumber - 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 pair
product_idtext - Only this pair, such as BTC-USD. Leave empty for every pair.
- Status
order_statustext - Only orders in this state. Leave empty for every state.One of:
OPEN,FILLED,CANCELLED(Canceled),EXPIRED,FAILED,PENDING. - Buy or sell
sidetext - Only buys or only sells. Leave empty for both.One of:
BUY,SELL. - From
start_timedate and time - Only those from this time on.
- Until
end_timedate and time - Only those before this time.
- How many
limitnumber - 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
- Account
accounttextRequired - The account, one per currency. Pick one, type its currency such as BTC, or give its id from 'List accounts'.
- How many
limitnumber - 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
- Currency
currencytext - Only pairs with this currency on either side, such as BTC or USD.
- Kind
product_typetext - Spot pairs or futures. Defaults to spot.One of:
SPOT(Spot (crypto pairs, the default)),FUTURE(Futures). - How many
limitnumber - 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
- Account
accounttextRequired - The account, one per currency. Pick one, type its currency such as BTC, or give its id from 'List accounts'.
- Type
transaction_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 many
limitnumber - 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 pair
product_idtextRequired - The pair, such as BTC-USD: the coin, then the currency it is priced in.
- Buy or sell
sidetextRequired - Buy the coin, or sell it.One of:
BUY,SELL. - Order type
order_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)). - Amount
amountnumberRequired - How much, as a plain number such as 25 or 0.001.At least 0.
- Amount is in
amount_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 price
limit_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 by
end_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 only
post_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 pair
product_idtextRequired - The pair, such as BTC-USD: the coin, then the currency it is priced in.
- Buy or sell
sidetextRequired - Buy the coin, or sell it.One of:
BUY,SELL. - Order type
order_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)). - Amount
amountnumberRequired - How much, as a plain number such as 25 or 0.001.At least 0.
- Amount is in
amount_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 price
limit_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 by
end_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 only
post_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
- Account
accounttextRequired - The account, one per currency. Pick one, type its currency such as BTC, or give its id from 'List accounts'.
- To
totextRequired - The crypto address, or the email address of a Coinbase user.
- Amount
amountnumberRequired - How much to send, in the account's currency, such as 0.01.At least 0.
- Network
networktext - The blockchain to send on, such as ethereum, base or solana. Leave empty for the currency's usual one.
- Destination tag or memo
destination_tagtext - The tag or memo the recipient asked for, for currencies such as XRP or XLM.
- Note
descriptiontext - 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"
}
}