GET
/
v1
/
wallets
/
{wallet_id}
/
addresses
/
{address_id}
/
trades
/
{trade_id}
Get trade by ID
curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v1/wallets/{wallet_id}/addresses/{address_id}/trades/{trade_id} \
  --header 'Authorization: Bearer <token>'
{
  "network_id": "base-sepolia",
  "wallet_id": "d91d652b-d020-48d4-bf19-5c5eb5e280c7",
  "address_id": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
  "trade_id": "d91d652b-d020-48d4-bf19-5c5eb5e280c7",
  "from_amount": "12345678",
  "from_asset": {
    "network_id": "base-sepolia",
    "asset_id": "USDC",
    "decimals": 18,
    "contract_address": "0x036CbD53842c5426634e7929541eC2318f3dCF7e"
  },
  "to_amount": "12345678",
  "to_asset": {
    "network_id": "base-sepolia",
    "asset_id": "USDC",
    "decimals": 18,
    "contract_address": "0x036CbD53842c5426634e7929541eC2318f3dCF7e"
  },
  "transaction": {
    "network_id": "base-sepolia",
    "from_address_id": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
    "unsigned_payload": "<string>",
    "signed_payload": "<string>",
    "transaction_hash": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
    "transaction_link": "https://sepolia.basescan.org/tx/0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
    "status": "pending",
    "content": {
      "from": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
      "gas": 1000,
      "gas_price": 1000,
      "hash": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
      "input": "<string>",
      "nonce": 136,
      "to": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
      "index": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
      "value": 100,
      "type": 2,
      "max_fee_per_gas": 190,
      "max_priority_fee_per_gas": 100,
      "priority_fee_per_gas": 1000,
      "transaction_access_list": {
        "access_list": [
          {
            "address": "<string>",
            "storage_keys": [
              "<any>"
            ]
          }
        ]
      },
      "flattened_traces": [
        {
          "error": "<string>",
          "type": "<string>",
          "from": "<string>",
          "to": "<string>",
          "value": "<string>",
          "gas": 123,
          "gas_used": 123,
          "input": "<string>",
          "output": "<string>",
          "sub_traces": 123,
          "trace_address": [
            123
          ],
          "trace_type": "<string>",
          "call_type": "<string>",
          "trace_id": "<string>",
          "status": 123,
          "block_hash": "<string>",
          "block_number": 123,
          "transaction_hash": "<string>",
          "transaction_index": 123
        }
      ],
      "block_timestamp": "2023-04-01T12:00:00Z",
      "mint": "0",
      "rlp_encoded_tx": "0x02f582426882013d8502540be4008502540be41c830493e094a55416de5de61a0ac1aa8970a280e04388b1de4b6f843a4b66f1c0808080"
    }
  },
  "approve_transaction": {
    "network_id": "base-sepolia",
    "from_address_id": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
    "unsigned_payload": "<string>",
    "signed_payload": "<string>",
    "transaction_hash": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
    "transaction_link": "https://sepolia.basescan.org/tx/0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
    "status": "pending",
    "content": {
      "from": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
      "gas": 1000,
      "gas_price": 1000,
      "hash": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
      "input": "<string>",
      "nonce": 136,
      "to": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
      "index": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
      "value": 100,
      "type": 2,
      "max_fee_per_gas": 190,
      "max_priority_fee_per_gas": 100,
      "priority_fee_per_gas": 1000,
      "transaction_access_list": {
        "access_list": [
          {
            "address": "<string>",
            "storage_keys": [
              "<any>"
            ]
          }
        ]
      },
      "flattened_traces": [
        {
          "error": "<string>",
          "type": "<string>",
          "from": "<string>",
          "to": "<string>",
          "value": "<string>",
          "gas": 123,
          "gas_used": 123,
          "input": "<string>",
          "output": "<string>",
          "sub_traces": 123,
          "trace_address": [
            123
          ],
          "trace_type": "<string>",
          "call_type": "<string>",
          "trace_id": "<string>",
          "status": 123,
          "block_hash": "<string>",
          "block_number": 123,
          "transaction_hash": "<string>",
          "transaction_index": 123
        }
      ],
      "block_timestamp": "2023-04-01T12:00:00Z",
      "mint": "0",
      "rlp_encoded_tx": "0x02f582426882013d8502540be4008502540be41c830493e094a55416de5de61a0ac1aa8970a280e04388b1de4b6f843a4b66f1c0808080"
    }
  }
}

Authorizations

​
Authorization
string
header
required

Enter your JSON Web Token (JWT) here. Refer to the Generate JWT section of our Authentication docs for information on how to generate your Bearer Token.

Path Parameters

​
wallet_id
string
required

The ID of the wallet the address belongs to.

​
address_id
string
required

The onchain address the trade belongs to.

​
trade_id
string
required

The ID of the trade to fetch.

Response

Success response

A trade of an asset to another asset

​
network_id
string
required

The ID of the blockchain network.

Example:

"base-sepolia"

​
wallet_id
string
required

The ID of the wallet that owns the from address

Example:

"d91d652b-d020-48d4-bf19-5c5eb5e280c7"

​
address_id
string
required

The onchain address of the sender

Example:

"0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a"

​
trade_id
string
required

The ID of the trade

Example:

"d91d652b-d020-48d4-bf19-5c5eb5e280c7"

​
from_amount
string
required

The amount of the from asset to be traded (in atomic units of the from asset)

Example:

"12345678"

​
from_asset
object
required

The asset being traded

​
to_amount
string
required

The amount of the to asset that will be received (in atomic units of the to asset)

Example:

"12345678"

​
to_asset
object
required

The asset received from the trade

​
transaction
object
required

The transaction that will execute the trade onchain

​
approve_transaction
object

An optional approval transaction that will be executed before the trade transaction if present