List transfers

List transfers

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

{
  "data": [
    {
      "network_id": "base-sepolia",
      "wallet_id": "d91d652b-d020-48d4-bf19-5c5eb5e280c7",
      "address_id": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
      "destination": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
      "amount": "12345678",
      "asset_id": "USDC",
      "asset": {
        "network_id": "base-sepolia",
        "asset_id": "USDC",
        "decimals": 18,
        "contract_address": "0x036CbD53842c5426634e7929541eC2318f3dCF7e"
      },
      "transfer_id": "d91d652b-d020-48d4-bf19-5c5eb5e280c7",
      "transaction": {
        "network_id": "base-sepolia",
        "from_address_id": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
        "transaction_hash": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
        "transaction_link": "https://sepolia.basescan.org/tx/0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
        "content": {
          "from": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
          "to": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
          "gas": 1000,
          "gas_price": 1000,
          "hash": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
          "nonce": 136,
          "index": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
          "value": 100,
          "type": 2,
          "max_fee_per_gas": 190,
          "max_priority_fee_per_gas": 100,
          "priority_fee_per_gas": 1000,
          "block_timestamp": "2023-04-01T12:00:00Z",
          "mint": "0",
          "rlp_encoded_tx": "0x02f582426882013d8502540be4008502540be41c830493e094a55416de5de61a0ac1aa8970a280e04388b1de4b6f843a4b66f1c0808080"
        }
      },
      "sponsored_send": {
        "to_address_id": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
        "transaction_hash": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
        "transaction_link": "https://sepolia.basescan.org/tx/0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42"
      },
      "transaction_hash": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42"
    }
  ],
  "total_count": 50
}

GET

wallets

{wallet_id}

addresses

{address_id}

transfers

List transfers

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

{
  "data": [
    {
      "network_id": "base-sepolia",
      "wallet_id": "d91d652b-d020-48d4-bf19-5c5eb5e280c7",
      "address_id": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
      "destination": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
      "amount": "12345678",
      "asset_id": "USDC",
      "asset": {
        "network_id": "base-sepolia",
        "asset_id": "USDC",
        "decimals": 18,
        "contract_address": "0x036CbD53842c5426634e7929541eC2318f3dCF7e"
      },
      "transfer_id": "d91d652b-d020-48d4-bf19-5c5eb5e280c7",
      "transaction": {
        "network_id": "base-sepolia",
        "from_address_id": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
        "transaction_hash": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
        "transaction_link": "https://sepolia.basescan.org/tx/0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
        "content": {
          "from": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
          "to": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
          "gas": 1000,
          "gas_price": 1000,
          "hash": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
          "nonce": 136,
          "index": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
          "value": 100,
          "type": 2,
          "max_fee_per_gas": 190,
          "max_priority_fee_per_gas": 100,
          "priority_fee_per_gas": 1000,
          "block_timestamp": "2023-04-01T12:00:00Z",
          "mint": "0",
          "rlp_encoded_tx": "0x02f582426882013d8502540be4008502540be41c830493e094a55416de5de61a0ac1aa8970a280e04388b1de4b6f843a4b66f1c0808080"
        }
      },
      "sponsored_send": {
        "to_address_id": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
        "transaction_hash": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
        "transaction_link": "https://sepolia.basescan.org/tx/0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42"
      },
      "transaction_hash": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42"
    }
  ],
  "total_count": 50
}

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 to list transfers for.

Query Parameters

limit

integer

A limit on the number of objects to be returned. Limit can range from 1 to 100, and the default is 10.

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 length: 5000

Response

The list of transfers for the given address.

data

object[]

required

A transfer of an asset from one address to another

Show child attributes

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"

destination

string

required

The onchain address of the recipient

Example:

"0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a"

amount

string

required

The amount in the atomic units of the asset

Example:

"12345678"

asset_id

string

required

The ID of the asset being transferred

Example:

"USDC"

asset

object

required

The asset being transferred

Show child attributes

asset.network_id

string

required

The ID of the blockchain network.

Example:

"base-sepolia"

asset.asset_id

string

required

The ID for the asset on the network

Example:

"USDC"

asset.decimals

integer

The number of decimals the asset supports. This is used to convert from atomic units to base units.

Example:

18

asset.contract_address

string

The optional contract address for the asset. This will be specified for smart contract-based assets, for example ERC20s.

Example:

"0x036CbD53842c5426634e7929541eC2318f3dCF7e"

transfer_id

string

required

The ID of the transfer

Example:

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

gasless

boolean

required

Whether the transfer uses sponsored gas

transaction

object

The transaction that will execute the transfer onchain

Show child attributes

transaction.network_id

string

required

Blockchain network identifier.

Example:

"base-sepolia"

transaction.from_address_id

string

required

The onchain address of the sender

Example:

"0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a"

transaction.unsigned_payload

string

required

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

transaction.status

enum<string>

required

The status of the transaction.

Available options:

pending,

signed,

broadcast,

complete,

failed,

unspecified

transaction.signed_payload

string

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

transaction.transaction_hash

string

The hash of the transaction

Example:

"0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42"

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

transaction.content

object

Show child attributes

transaction.content.from

string

required

The onchain address of the sender.

Example:

"0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a"

transaction.content.to

string

required

The onchain address of the receiver.

Example:

"0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a"

transaction.content.gas

integer<uint64>

The amount of gas spent in the transaction.

Example:

1000

transaction.content.gas_price

integer<uint64>

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

Example:

1000

transaction.content.hash

string

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

Example:

"0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42"

transaction.content.input

string

The input data of the transaction.

transaction.content.nonce

integer<uint64>

The nonce of the transaction in the source address.

Example:

136

transaction.content.index

integer<uint64>

The index of the transaction in the block.

Example:

"0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42"

transaction.content.value

string

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

Example:

100

transaction.content.type

integer<uint64>

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

Example:

2

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

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

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

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

transaction.content.transaction_access_list.access_list

object[]

Show child attributes

address

string

storage_keys

string[]

transaction.content.flattened_traces

object[]

Traces associated with the transaction.

Show child attributes

error

string

type

string

from

string

value

string

gas

integer<uint64>

gas_used

integer<uint64>

input

string

output

string

sub_traces

integer<uint64>

trace_address

integer<uint64>[]

trace_type

string

call_type

string

trace_id

string

status

integer<uint64>

block_hash

string

block_number

integer<uint64>

transaction_hash

string

transaction_index

integer<uint64>

transaction.content.block_timestamp

string<date-time>

The timestamp of the block in which the event was emitted

Example:

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

transaction.content.mint

string

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

Example:

"0"

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

sponsored_send

object

The sponsored gasless send

Show child attributes

sponsored_send.to_address_id

string

required

The onchain address of the recipient

Example:

"0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a"

sponsored_send.raw_typed_data

string

required

The raw typed data for the sponsored send

sponsored_send.typed_data_hash

string

required

The typed data hash for the sponsored send. This is the typed data hash that needs to be signed by the sender.

sponsored_send.status

enum<string>

required

The status of the sponsored send

Available options:

pending,

signed,

submitted,

complete,

failed

sponsored_send.signature

string

The signed hash of the sponsored send typed data.

sponsored_send.transaction_hash

string

The hash of the onchain sponsored send transaction

Example:

"0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42"

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

unsigned_payload

string

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

signed_payload

string

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

transaction_hash

string

The hash of the transfer transaction

Example:

"0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42"

status

enum<string>

The status of the transfer

Available options:

pending,

broadcast,

complete,

failed

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.

total_count

integer

required

The total number of transfers for the address in the wallet.

Example:

50

Get transfer by ID

Create wallet

⌘I

CDP API V1

REST API

JSON-RPC API

Authorizations

Path Parameters

Query Parameters

Response