# Coinbase

> 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.

App · 24 actions. Web page: https://docs.lodol.com/docs/integrations/coinbase

## Actions

### 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_ids`, list, required): The ids of the orders to cancel, from 'List orders' or 'Place order'.

**Outputs**

- `canceled_count` (number): How many were canceled
- `failed_count` (number): How many weren't
- `results` (list): One entry per order

**Example output**

```json
{
  "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_id`, text, required): The trade_id from 'Get conversion quote'.
- From (`from_currency`, text, required): 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_currency`, text, required): 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**

- `status` (text): TRADE_STATUS_CREATED for a quote, then STARTED, COMPLETED or CANCELED
- `trade` (object): A conversion or quote
- `trade_id` (text): The conversion's id, for 'Convert' and 'Get conversion'

**Example output**

```json
{
  "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 (`account`, text, required): The account, one per currency. Pick one, type its currency such as BTC, or give its id from 'List accounts'.
- Label (`address_name`, text): Your own label for the address, such as an invoice number.
- Network (`network`, text): The blockchain, such as ethereum, base, solana or bitcoin. Leave empty for the currency's usual one.

**Outputs**

- `address` (object): A receive address

**Example output**

```json
{
  "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 (`account`, text, required): The account, one per currency. Pick one, type its currency such as BTC, or give its id from 'List accounts'.

**Outputs**

- `account` (object): A Coinbase account, which holds one currency

**Example output**

```json
{
  "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_ids`, list, required): One or more pairs, such as BTC-USD and ETH-USD.

**Outputs**

- `count` (number): How many were returned
- `prices` (list): One entry per pair

**Example output**

```json
{
  "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_id`, text, required): The trade_id from 'Get conversion quote'.
- From (`from_currency`, text, required): 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_currency`, text, required): 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**

- `status` (text): TRADE_STATUS_CREATED for a quote, then STARTED, COMPLETED or CANCELED
- `trade` (object): A conversion or quote
- `trade_id` (text): The conversion's id, for 'Convert' and 'Get conversion'

**Example output**

```json
{
  "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_currency`, text, required): 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_currency`, text, required): 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 (`amount`, number, required): How much to convert, in the From currency, such as 100. At least 0.

**Outputs**

- `status` (text): TRADE_STATUS_CREATED for a quote, then STARTED, COMPLETED or CANCELED
- `trade` (object): A conversion or quote
- `trade_id` (text): The conversion's id, for 'Convert' and 'Get conversion'

**Example output**

```json
{
  "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_type`, text): Spot or futures trading. Leave empty for both. One of: `SPOT` (Spot (crypto pairs, the default)), `FUTURE` (Futures).

**Outputs**

- `maker_fee_rate` (number): The maker fee, such as 0.004 for 0.4%
- `pricing_tier` (text): Your fee tier's name
- `summary` (object): Coinbase's whole answer, with the volume broken down
- `taker_fee_rate` (number): The taker fee, such as 0.006 for 0.6%
- `total_fees` (number): The fees you've paid over that time, in USD
- `total_volume` (number): Your trading volume over the last 30 days, in USD

**Example output**

```json
{
  "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_trade` (true/false): True if the key can place orders and convert
- `can_transfer` (true/false): True if the key can send crypto
- `can_view` (true/false): True if the key can read the account
- `portfolio_type` (text): That portfolio's type, such as DEFAULT
- `portfolio_uuid` (text): The portfolio the key works in

**Example output**

```json
{
  "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_id`, text, required): The order's id, from 'Place order' or 'List orders'.

**Outputs**

- `order` (object): An order

**Example output**

```json
{
  "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_id`, text, required): The portfolio. Pick one, or give its id from 'List portfolios'.
- Value in (`currency`, text): The currency to value holdings in, such as USD or EUR.

**Outputs**

- `balances` (object): The portfolio's totals
- `count` (number): How many were returned
- `portfolio` (object): A portfolio
- `spot_positions` (list): What it holds

**Example output**

```json
{
  "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_id`, text, required): The pair, such as BTC-USD: the coin, then the currency it is priced in.

**Outputs**

- `product` (object): A trading pair

**Example output**

```json
{
  "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 (`account`, text, required): The account, one per currency. Pick one, type its currency such as BTC, or give its id from 'List accounts'.
- Transaction ID (`transaction_id`, text, required): The transaction's id, from 'List transactions' or 'Send crypto'.

**Outputs**

- `transaction` (object): A transaction on an account

**Example output**

```json
{
  "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_empty`, true/false): Also list accounts with nothing in them.
- How many (`limit`, number): At most this many, newest first, 1 to 1000. Defaults to 1000. From 1 to 1000.

**Outputs**

- `accounts` (list): The accounts
- `count` (number): How many were returned

**Example output**

```json
{
  "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_id`, text): Only this order's fills. Leave empty for every order.
- Trading pair (`product_id`, text): Only this pair, such as BTC-USD. Leave empty for every pair.
- From (`start_time`, date and time): Only those from this time on.
- Until (`end_time`, date and time): Only those before this time.
- How many (`limit`, number): At most this many, newest first, 1 to 300. Defaults to 25. From 1 to 300.

**Outputs**

- `count` (number): How many were returned
- `fills` (list): The fills

**Example output**

```json
{
  "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_id`, text): Only this pair, such as BTC-USD. Leave empty for every pair.
- Status (`order_status`, text): Only orders in this state. Leave empty for every state. One of: `OPEN`, `FILLED`, `CANCELLED` (Canceled), `EXPIRED`, `FAILED`, `PENDING`.
- Buy or sell (`side`, text): Only buys or only sells. Leave empty for both. One of: `BUY`, `SELL`.
- From (`start_time`, date and time): Only those from this time on.
- Until (`end_time`, date and time): Only those before this time.
- How many (`limit`, number): At most this many, newest first, 1 to 300. Defaults to 25. From 1 to 300.

**Outputs**

- `count` (number): How many were returned
- `orders` (list): The orders

**Example output**

```json
{
  "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**

- `count` (number): How many were returned
- `payment_methods` (list): The payment methods

**Example output**

```json
{
  "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**

- `count` (number): How many were returned
- `portfolios` (list): The portfolios

**Example output**

```json
{
  "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 (`account`, text, required): The account, one per currency. Pick one, type its currency such as BTC, or give its id from 'List accounts'.
- How many (`limit`, number): At most this many, newest first, 1 to 300. Defaults to 25. From 1 to 300.

**Outputs**

- `account_id` (text): The account's id
- `addresses` (list): The addresses
- `count` (number): How many were returned

**Example output**

```json
{
  "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 (`currency`, text): Only pairs with this currency on either side, such as BTC or USD.
- Kind (`product_type`, text): Spot pairs or futures. Defaults to spot. One of: `SPOT` (Spot (crypto pairs, the default)), `FUTURE` (Futures).
- How many (`limit`, number): At most this many, newest first, 1 to 1000. Defaults to 50. From 1 to 1000.

**Outputs**

- `count` (number): How many were returned
- `products` (list): The trading pairs

**Example output**

```json
{
  "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 (`account`, text, required): The account, one per currency. Pick one, type its currency such as BTC, or give its id from 'List accounts'.
- Type (`transaction_type`, text): 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 (`limit`, number): At most this many, newest first, 1 to 300. Defaults to 25. From 1 to 300.

**Outputs**

- `account_id` (text): The account's id
- `count` (number): How many were returned
- `transactions` (list): The transactions

**Example output**

```json
{
  "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_id`, text, required): The pair, such as BTC-USD: the coin, then the currency it is priced in.
- Buy or sell (`side`, text, required): Buy the coin, or sell it. One of: `BUY`, `SELL`.
- Order type (`order_type`, text, required): 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 (`amount`, number, required): How much, as a plain number such as 25 or 0.001. At least 0.
- Amount is in (`amount_in`, text, required): 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_price`, number): 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_time`, date 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_only`, true/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_id` (text): The reference the order was placed with
- `order_configuration` (object): 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_id` (text): The new order's id
- `product_id` (text): The pair, such as BTC-USD
- `side` (text): BUY or SELL

**Example output**

```json
{
  "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_id`, text, required): The pair, such as BTC-USD: the coin, then the currency it is priced in.
- Buy or sell (`side`, text, required): Buy the coin, or sell it. One of: `BUY`, `SELL`.
- Order type (`order_type`, text, required): 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 (`amount`, number, required): How much, as a plain number such as 25 or 0.001. At least 0.
- Amount is in (`amount_in`, text, required): 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_price`, number): 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_time`, date 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_only`, true/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_size` (number): The amount in coins
- `best_ask` (number): The lowest ask now
- `best_bid` (number): The highest bid now
- `commission_total` (number): The fees
- `errors` (list): Why Coinbase would refuse it, such as PREVIEW_INSUFFICIENT_FUND
- `est_average_filled_price` (number): The average price it would likely fill at
- `ok` (true/false): True when Coinbase would accept the order as it stands
- `order_total` (number): What the order would cost or bring in, with fees
- `preview_id` (text): The preview's id
- `quote_size` (number): The amount in money
- `warnings` (list): Warnings, such as BIG_ORDER

**Example output**

```json
{
  "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 (`account`, text, required): The account, one per currency. Pick one, type its currency such as BTC, or give its id from 'List accounts'.
- To (`to`, text, required): The crypto address, or the email address of a Coinbase user.
- Amount (`amount`, number, required): How much to send, in the account's currency, such as 0.01. At least 0.
- Network (`network`, text): The blockchain to send on, such as ethereum, base or solana. Leave empty for the currency's usual one.
- Destination tag or memo (`destination_tag`, text): The tag or memo the recipient asked for, for currencies such as XRP or XLM.
- Note (`description`, text): A note for the recipient, sent with an email send.

**Outputs**

- `transaction` (object): A transaction on an account

**Example output**

```json
{
  "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"
  }
}
```
