List Coinbase account balances

curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v2/coinbase-accounts/balances

const options = {method: 'GET'};

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",
]);

$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)

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

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

	fmt.Println(string(body))

}

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)

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 Sessions

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

const options = {method: 'GET'};

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",
]);

$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)

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

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

	fmt.Println(string(body))

}

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)

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"
        }
      }
    }
  ]
}

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"
      }
    }
  }
]

⌘I

CDP API

REST API

List Coinbase account balances

Response