POST
/
v1
/
wallets
/
{wallet_id}
/
addresses
/
{address_id}
/
transfers
Create transfer
curl --request POST \
  --url https://api.cdp.coinbase.com/platform/v1/wallets/{wallet_id}/addresses/{address_id}/transfers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": 1.05,
  "network_id": "ethereum-mainnet",
  "asset_id": "eth",
  "destination": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
  "gasless": true
}'
{
  "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",
    "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": [
              "<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"
    }
  },
  "sponsored_send": {
    "to_address_id": "0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a",
    "raw_typed_data": "<string>",
    "typed_data_hash": "<string>",
    "signature": "<string>",
    "transaction_hash": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
    "transaction_link": "https://sepolia.basescan.org/tx/0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
    "status": "pending"
  },
  "unsigned_payload": "<string>",
  "signed_payload": "<string>",
  "transaction_hash": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
  "status": "pending",
  "gasless": true
}

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 source address belongs to.

​
address_id
string
required

The onchain address to transfer from.

Body

application/json
​
amount
string
required

The amount to transfer.

Example:

1.05

​
network_id
string
required

The ID of the blockchain network.

Example:

"ethereum-mainnet"

​
asset_id
string
required

The ID of the asset to transfer.

Example:

"eth"

​
destination
string
required

The destination address.

Example:

"0xfc807D1bE4997e5C7B33E4d8D57e60c5b0f02B1a"

​
gasless
boolean

Whether the transfer uses sponsored gas.

Response

The created transfer

A transfer of an asset from one address to another

​
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

​
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

​
sponsored_send
object

The sponsored gasless send

​
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