Transfers
Create transfer
CDP API V1
REST API
- Addresses
- Assets
- Networks
- Smart Contracts
- Staking
- Trades
- Transfers
- Wallets
- Webhooks
- Onramp/Offramp
JSON-RPC API
Transfers
Create transfer
Create a new transfer.
POST
/
v1
/
wallets
/
{wallet_id}
/
addresses
/
{address_id}
/
transfers
Copy
Ask AI
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
}'
Copy
Ask AI
{
"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
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
The ID of the wallet the source address belongs to.
The onchain address to transfer from.
Body
application/json
Response
200
application/json
The created transfer
A transfer of an asset from one address to another
Was this page helpful?
Copy
Ask AI
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
}'
Copy
Ask AI
{
"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
}
Assistant
Responses are generated using AI and may contain mistakes.