POST
/
v1
/
wallets
/
{wallet_id}
/
addresses
/
{address_id}
/
transfers
/
{transfer_id}
/
broadcast
Broadcast transfer
curl --request POST \
  --url https://api.cdp.coinbase.com/platform/v1/wallets/{wallet_id}/addresses/{address_id}/transfers/{transfer_id}/broadcast \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "signed_payload": "<string>"
}'
{
  "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 address belongs to.

​
address_id
string
required

The onchain address the transfer belongs to.

​
transfer_id
string
required

The ID of the transfer to broadcast.

Body

application/json
​
signed_payload
string
required

The hex-encoded signed payload of the transfer

Response

Success response

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