Get address transaction history

curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v1/networks/{network_id}/addresses/{address_id}/transactions \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "network_id": "base-sepolia",
      "from_address_id": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
      "unsigned_payload": "<string>",
      "status": "pending",
      "signed_payload": "<string>",
      "transaction_hash": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
      "transaction_link": "https://sepolia.basescan.org/tx/0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
      "content": {
        "from": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
        "to": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
        "gas": 1000,
        "gas_price": 1000,
        "hash": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
        "input": "<string>",
        "nonce": 136,
        "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": [
                "<string>"
              ]
            }
          ]
        },
        "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"
      }
    }
  ],
  "has_more": true,
  "next_page": "<string>"
}

GET

networks

{network_id}

addresses

{address_id}

transactions

Get address transaction history

curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v1/networks/{network_id}/addresses/{address_id}/transactions \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "network_id": "base-sepolia",
      "from_address_id": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
      "unsigned_payload": "<string>",
      "status": "pending",
      "signed_payload": "<string>",
      "transaction_hash": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
      "transaction_link": "https://sepolia.basescan.org/tx/0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
      "content": {
        "from": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
        "to": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
        "gas": 1000,
        "gas_price": 1000,
        "hash": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
        "input": "<string>",
        "nonce": 136,
        "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": [
                "<string>"
              ]
            }
          ]
        },
        "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"
      }
    }
  ],
  "has_more": true,
  "next_page": "<string>"
}

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

network_id

string

required

Blockchain network identifier.

address_id

string

required

Blockchain address hash (Note that EVM chain address hash should be lowered cased).

Query Parameters

limit

integer

Number of transactions to receive in a page. The default value is 10. The maximum value is 100, and values supplied over this will be coerced to the maximum.

page

string

A cursor for pagination across multiple pages of results. Don't include this parameter on the first call. Use the next_page value returned in a previous response to request subsequent results.

Maximum string length: 5000

Response

Success response

data

object[]

required

Show child attributes

data.network_id

string

required

Blockchain network identifier.

Example:

"base-sepolia"

data.from_address_id

string

required

The onchain address of the sender

Example:

"0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a"

data.unsigned_payload

string

required

The unsigned payload of the transaction. This is the payload that needs to be signed by the sender.

data.status

enum<string>

required

The status of the transaction.

Available options:

pending,

signed,

broadcast,

complete,

failed,

unspecified

data.signed_payload

string

The signed payload of the transaction. This is the payload that has been signed by the sender.

data.transaction_hash

string

The hash of the transaction

Example:

"0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42"

data.transaction_link

string

The link to view the transaction on a block explorer. This is optional and may not be present for all transactions.

Example:

"https://sepolia.basescan.org/tx/0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42"

data.content

object

Show child attributes

data.content.from

string

required

The onchain address of the sender.

Example:

"0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a"

data.content.to

string

required

The onchain address of the receiver.

Example:

"0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a"

data.content.gas

integer<uint64>

The amount of gas spent in the transaction.

Example:

1000

data.content.gas_price

integer<uint64>

The price per gas spent in the transaction in atomic units of the native asset.

Example:

1000

data.content.hash

string

The hash of the transaction as a hexadecimal string, prefixed with 0x.

Example:

"0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42"

data.content.input

string

The input data of the transaction.

data.content.nonce

integer<uint64>

The nonce of the transaction in the source address.

Example:

136

data.content.index

integer<uint64>

The index of the transaction in the block.

Example:

"0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42"

data.content.value

string

The value of the transaction in atomic units of the native asset.

Example:

100

data.content.type

integer<uint64>

The EIP-2718 transaction type. See https://eips.ethereum.org/EIPS/eip-2718 for more details.

Example:

2

data.content.max_fee_per_gas

integer<uint64>

The max fee per gas as defined in EIP-1559. https://eips.ethereum.org/EIPS/eip-1559 for more details.

Example:

190

data.content.max_priority_fee_per_gas

integer<uint64>

The max priority fee per gas as defined in EIP-1559. https://eips.ethereum.org/EIPS/eip-1559 for more details.

Example:

100

data.content.priority_fee_per_gas

integer<uint64>

The confirmed priority fee per gas as defined in EIP-1559. https://eips.ethereum.org/EIPS/eip-1559 for more details.

Example:

1000

data.content.transaction_access_list

object

The transaction access list as defined in EIP-2930. https://eips.ethereum.org/EIPS/eip-2930 for more details.

Show child attributes

data.content.transaction_access_list.access_list

object[]

Show child attributes

data.content.transaction_access_list.access_list.address

string

data.content.transaction_access_list.access_list.storage_keys

string[]

data.content.flattened_traces

object[]

Show child attributes

data.content.flattened_traces.error

string

data.content.flattened_traces.type

string

data.content.flattened_traces.from

string

data.content.flattened_traces.to

string

data.content.flattened_traces.value

string

data.content.flattened_traces.gas

integer<uint64>

data.content.flattened_traces.gas_used

integer<uint64>

data.content.flattened_traces.input

string

data.content.flattened_traces.output

string

data.content.flattened_traces.sub_traces

integer<uint64>

data.content.flattened_traces.trace_address

integer<uint64>[]

data.content.flattened_traces.trace_type

string

data.content.flattened_traces.call_type

string

data.content.flattened_traces.trace_id

string

data.content.flattened_traces.status

integer<uint64>

data.content.flattened_traces.block_hash

string

data.content.flattened_traces.block_number

integer<uint64>

data.content.flattened_traces.transaction_hash

string

data.content.flattened_traces.transaction_index

integer<uint64>

data.content.block_timestamp

string<date-time>

The timestamp of the block in which the event was emitted

Example:

"2023-04-01T12:00:00Z"

data.content.mint

string

This is for handling optimism rollup specific EIP-2718 transaction type field.

Example:

"0"

data.content.rlp_encoded_tx

string

RLP encoded transaction as a hex string (prefixed with 0x) for native compatibility with popular eth clients such as etherjs, viem etc.

Example:

"0x02f582426882013d8502540be4008502540be41c830493e094a55416de5de61a0ac1aa8970a280e04388b1de4b6f843a4b66f1c0808080"

has_more

boolean

required

True if this list has another page of items after this one that can be fetched.

next_page

string

required

The page token to be used to fetch the next page.

Get address balance history for asset

Get wallet address

⌘I

CDP API V1

REST API

JSON-RPC API

Get address transaction history

Authorizations

Path Parameters

Query Parameters

Response