List Coinbase account balances

curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v2/coinbase-accounts/balances \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.cdp.coinbase.com/platform/v2/coinbase-accounts/balances"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.cdp.coinbase.com/platform/v2/coinbase-accounts/balances', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cdp.coinbase.com/platform/v2/coinbase-accounts/balances",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cdp.coinbase.com/platform/v2/coinbase-accounts/balances"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.cdp.coinbase.com/platform/v2/coinbase-accounts/balances")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cdp.coinbase.com/platform/v2/coinbase-accounts/balances")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "balances": [
    {
      "asset": {
        "symbol": "usdc",
        "type": "crypto",
        "name": "USD Coin",
        "decimals": 6
      },
      "amount": {
        "usdc": {
          "available": "50.00",
          "total": "100.00"
        }
      }
    }
  ]
}

Payment Acceptance

List Coinbase account balances

Returns the balances held in the Coinbase account.

The available amount is the immediately spendable balance. The total amount also includes funds currently on hold. Both amounts are returned as decimal strings with 2 decimal places (e.g. "50.00").

Authentication: Requires a Coinbase OAuth Bearer token with the coinbase:stablecoins:balance-read scope.

Returned assets: Currently always returns a single USDC entry. If the payer holds no USDC, the entry is still returned with an available and total of "0" so callers do not need to special-case a missing asset. Additional assets may be returned in the future without a contract change.

GET

coinbase-accounts

balances

List Coinbase account balances

curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v2/coinbase-accounts/balances \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.cdp.coinbase.com/platform/v2/coinbase-accounts/balances"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.cdp.coinbase.com/platform/v2/coinbase-accounts/balances', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cdp.coinbase.com/platform/v2/coinbase-accounts/balances",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cdp.coinbase.com/platform/v2/coinbase-accounts/balances"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.cdp.coinbase.com/platform/v2/coinbase-accounts/balances")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cdp.coinbase.com/platform/v2/coinbase-accounts/balances")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "balances": [
    {
      "asset": {
        "symbol": "usdc",
        "type": "crypto",
        "name": "USD Coin",
        "decimals": 6
      },
      "amount": {
        "usdc": {
          "available": "50.00",
          "total": "100.00"
        }
      }
    }
  ]
}

Authorizations

Authorization

string

header

required

A Coinbase OAuth Bearer token provided by the end user (payer). EntryGateway terminates the OAuth token and mints a scoped CAT (Coinbase Auth Token) JWT for downstream services.

Response

Successfully retrieved Coinbase account balances.

A list of balances for an account.

balances

object[]

required

The list of balances.

Show child attributes

Example:

[
  {
    "asset": {
      "symbol": "btc",
      "type": "crypto",
      "name": "Bitcoin",
      "decimals": 8
    },
    "amount": {
      "btc": { "available": "2.5", "total": "3.0" },
      "usd": {
        "available": "252705.4",
        "total": "303246.48"
      }
    }
  }
]

Get wallet authorization options

List disbursements

⌘I

Resource Guides

REST API

List Coinbase account balances

Authorizations

Response