Table of Endpoints Name Method Endpoint Legacy Scope CDP API Key Scope Create Address POST /v2/accounts/:account_id/addresseswallet:addresses:createtransferList Addresses GET /v2/accounts/:account_id/addresseswallet:addresses:readviewShow Address GET /v2/accounts/:account_id/addresses/:address_idwallet:addresses:readviewList Transactions GET /v2/accounts/:account_id/addresses/:address_id/transactionswallet:transactions:readview
Overview The Address resource represents an address for any Coinbase supported asset . An account can have more than one address, but an address can only be associated with one account.
To be notified when an address receives a new transactions, you can set up an API notification
Parameter Description id string Resource ID address string Address for any Coinbase supported asset name string, optional User defined label for the address network string Name of blockchain created_at timestamp updated_at timestamp resource string, constant address resource_path string
Example Address Resource { "id" : "dd3183eb-af1d-5f5d-a90d-cbff946435ff" , "address" : "mswUGcPHp1YnkLCgF1TtoryqSc5E9Q8xFa" , "name" : "One off payment" , "created_at" : "2015-01-31T20:49:02Z" , "updated_at" : "2015-03-31T17:25:29-07:00" , "network" : "bitcoin" , "resource" : "address" , "resource_path" : "/v2/accounts/2bbf394c-193b-5b2a-9155-3b4732659ede/addresses/dd3183eb-af1d-5f5d-a90d-cbff946435ff" } Create Address Creates a new address for an account. Addresses can be created for wallet account types.
You can create an address with an empty POST request as all arguments are optional. This is handy if you need to create new receive addresses for an account on-demand.
HTTP Request POST https://api.coinbase.com/v2/accounts/:account_id/addresses
Scopes Arguments Parameter Type Required Description name string Optional Address label
Examples Request Shell
Ruby
Python
JavaScript
curl https://api.coinbase.com/v2/accounts/82de7fcd-db72-5085-8ceb-bee19303080b/addresses \ -X POST \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer abd90df5f27a7b170cd775abf89d632b350b7c1c9d53e08b340cd9832ce52c2c' \ -d '{"name": "New receive address"}' }
Response (201) { "data" : { "id" : "dd3183eb-af1d-5f5d-a90d-cbff946435ff" , "address" : "mswUGcPHp1YnkLCgF1TtoryqSc5E9Q8xFa" , "name" : "New receive address" , "created_at" : "2015-01-31T20:49:02Z" , "updated_at" : "2015-03-31T17:25:29-07:00" , "network" : "bitcoin" , "resource" : "address" , "resource_path" : "/v2/accounts/2bbf394c-193b-5b2a-9155-3b4732659ede/addresses/dd3183eb-af1d-5f5d-a90d-cbff946435ff" } } List Addresses Lists addresses for an account.
An address can only be associated with one account. See Create Address to create new addresses.
HTTP Request GET https://api.coinbase.com/v2/accounts/:account_id/addresses
Scopes Examples Request Shell
Ruby
Python
JavaScript
curl https://api.coinbase.com/v2/accounts/2bbf394c-193b-5b2a-9155-3b4732659ede/addresses \ -H 'Authorization: Bearer abd90df5f27a7b170cd775abf89d632b350b7c1c9d53e08b340cd9832ce52c2c'
Response { "pagination" : { "ending_before" : null , "starting_after" : null , "limit" : 25 , "order" : "desc" , "previous_uri" : null , "next_uri" : null }, "data" : [ { "id" : "dd3183eb-af1d-5f5d-a90d-cbff946435ff" , "address" : "mswUGcPHp1YnkLCgF1TtoryqSc5E9Q8xFa" , "name" : null , "created_at" : "2015-01-31T20:49:02Z" , "updated_at" : "2015-03-31T17:25:29-07:00" , "network" : "bitcoin" , "resource" : "address" , "resource_path" : "/v2/accounts/2bbf394c-193b-5b2a-9155-3b4732659ede/addresses/dd3183eb-af1d-5f5d-a90d-cbff946435ff" }, { "id" : "ac5c5f15-0b1d-54f5-8912-fecbf66c2a64" , "address" : "mgSvu1z1amUFAPkB4cUg8ujaDxKAfZBt5Q" , "name" : null , "created_at" : "2015-03-31T17:23:52-07:00" , "updated_at" : "2015-01-31T20:49:02Z" , "network" : "bitcoin" , "resource" : "address" , "resource_path" : "/v2/accounts/2bbf394c-193b-5b2a-9155-3b4732659ede/addresses/ac5c5f15-0b1d-54f5-8912-fecbf66c2a64" } ] } Show Address Get an single address for an account.
An address can only be associated with one account. See Create Address to create new addresses.
HTTP Request GET https://api.coinbase.com/v2/accounts/:account_id/addresses/:address_id
Scopes Examples Request Shell
Ruby
Python
JavaScript
curl https://api.coinbase.com/v2/accounts/2bbf394c-193b-5b2a-9155-3b4732659ede/addresses/dd3183eb-af1d-5f5d-a90d-cbff946435ff \ -H 'Authorization: Bearer abd90df5f27a7b170cd775abf89d632b350b7c1c9d53e08b340cd9832ce52c2c'
Response { "data" : { "id" : "dd3183eb-af1d-5f5d-a90d-cbff946435ff" , "address" : "mswUGcPHp1YnkLCgF1TtoryqSc5E9Q8xFa" , "name" : null , "callback_url" : null , "created_at" : "2015-01-31T20:49:02Z" , "updated_at" : "2015-03-31T17:25:29-07:00" , "network" : "bitcoin" , "resource" : "address" , "resource_path" : "/v2/accounts/2bbf394c-193b-5b2a-9155-3b4732659ede/addresses/dd3183eb-af1d-5f5d-a90d-cbff946435ff/" } } List Transactions List transactions that have been sent to a specific address.
HTTP Request GET https://api.coinbase.com/v2/accounts/:account_id/addresses/:address_id/transactions
Scopes Examples Request Shell
Ruby
Python
JavaScript
curl https://api.coinbase.com/v2/accounts/2bbf394c-193b-5b2a-9155-3b4732659ede/addresses/dd3183eb-af1d-5f5d-a90d-cbff946435ff/transactions \ -H 'Authorization: Bearer abd90df5f27a7b170cd775abf89d632b350b7c1c9d53e08b340cd9832ce52c2c'
Response { "pagination" : { "ending_before" : null , "starting_after" : null , "limit" : 25 , "order" : "desc" , "previous_uri" : null , "next_uri" : null }, "data" : [ { "id" : "57ffb4ae-0c59-5430-bcd3-3f98f797a66c" , "type" : "send" , "status" : "completed" , "amount" : { "amount" : "0.00100000" , "currency" : "BTC" }, "native_amount" : { "amount" : "0.01" , "currency" : "USD" }, "description" : null , "created_at" : "2015-03-11T13:13:35-07:00" , "updated_at" : "2015-03-26T15:55:43-07:00" , "resource" : "transaction" , "resource_path" : "/v2/accounts/2bbf394c-193b-5b2a-9155-3b4732659ede/transactions/57ffb4ae-0c59-5430-bcd3-3f98f797a66c" , "network" : { "status" : "off_blockchain" , "name" : "bitcoin" }, "from" : { "id" : "a6b4c2df-a62c-5d68-822a-dd4e2102e703" , "resource" : "user" } } ] } 
