> ## Documentation Index
> Fetch the complete documentation index at: https://docs.daya.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Balances

> Retrieve account balances for all currencies

## Overview

Get the current balance for all currencies in your Pro account. This endpoint requires authentication with an API key that has **Read** scope.

<Info>
  **Unified Balance:** USDT, USDC, and USD are all mapped to a single unified USD balance. When you trade with any of these symbols (USDT-NGN, USDC-NGN, or USD-NGN), they all use the same USD balance.
</Info>

## Authentication

<ParamField header="X-Api-Key" type="string" required>
  Your API key with Read scope

  ```
  X-Api-Key: daya_sk_YOUR_API_KEY
  ```
</ParamField>

## Request Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url https://api.pro.daya.co/public/v1/balances \
    --header 'X-Api-Key: daya_sk_YOUR_API_KEY'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.pro.daya.co/public/v1/balances', {
    headers: {
      'X-Api-Key': 'daya_sk_YOUR_API_KEY'
    }
  });

  const result = await response.json();
  console.log(result.data.balances);
  ```

  ```python Python theme={null}
  import requests

  headers = {
      'X-Api-Key': 'daya_sk_YOUR_API_KEY'
  }

  response = requests.get(
      'https://api.pro.daya.co/public/v1/balances',
      headers=headers
  )

  result = response.json()
  print(result['data']['balances'])
  ```

  ```go Go theme={null}
  package main

  import (
      "encoding/json"
      "fmt"
      "net/http"
  )

  func main() {
      client := &http.Client{}
      req, _ := http.NewRequest("GET", "https://api.pro.daya.co/public/v1/balances", nil)
      req.Header.Add("X-Api-Key", "daya_sk_YOUR_API_KEY")

      resp, err := client.Do(req)
      if err != nil {
          panic(err)
      }
      defer resp.Body.Close()

      var data map[string]interface{}
      json.NewDecoder(resp.Body).Decode(&data)
      fmt.Println(data["data"])
  }
  ```
</CodeGroup>

## Response

<ResponseField name="success" type="boolean" required>
  Indicates if the request was successful
</ResponseField>

<ResponseField name="message" type="string" required>
  Human-readable response message
</ResponseField>

<ResponseField name="data" type="object" required>
  Balances wrapper object

  <Expandable title="data properties">
    <ResponseField name="balances" type="array">
      Array of balance objects

      <Expandable title="balance properties">
        <ResponseField name="currency" type="string">
          Currency code

          **Example:** `USD`, `NGN`
        </ResponseField>

        <ResponseField name="total_balance" type="string">
          Total balance (available + held)

          **Example:** `1500.00`
        </ResponseField>

        <ResponseField name="available_balance" type="string">
          Available balance (can be used for trading)

          **Example:** `1000.00`
        </ResponseField>

        <ResponseField name="held_balance" type="string">
          Held balance (locked in open orders)

          **Example:** `500.00`
        </ResponseField>

        <ResponseField name="used_credit" type="string">
          Outstanding credit debt

          **Example:** `0.00`
        </ResponseField>

        <ResponseField name="held_credit" type="string">
          Credit held in open orders

          **Example:** `0.00`
        </ResponseField>

        <ResponseField name="available_credit" type="string">
          Available credit to use

          **Example:** `0.00`
        </ResponseField>

        <ResponseField name="credit_limit" type="string">
          Total credit limit

          **Example:** `0.00`
        </ResponseField>

        <ResponseField name="usd_rate" type="string">
          Current USD exchange rate for this currency

          **Example:** `1.00`
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="timestamp" type="string">
  ISO 8601 timestamp of the response
</ResponseField>

### Success Response

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "success": true,
    "message": "Balances retrieved successfully",
    "data": {
      "balances": [
        {
          "currency": "USD",
          "total_balance": "1500.00",
          "available_balance": "1000.00",
          "held_balance": "500.00",
          "used_credit": "0.00",
          "held_credit": "0.00",
          "available_credit": "0.00",
          "credit_limit": "0.00",
          "usd_rate": "1.00"
        },
        {
          "currency": "NGN",
          "total_balance": "1545000.00",
          "available_balance": "1545000.00",
          "held_balance": "0.00",
          "used_credit": "0.00",
          "held_credit": "0.00",
          "available_credit": "0.00",
          "credit_limit": "0.00",
          "usd_rate": "0.00065"
        }
      ]
    },
    "timestamp": "2024-01-15T10:30:00Z"
  }
  ```
</ResponseExample>

## Error Responses

### 401 Unauthorized

<ResponseExample>
  ```json 401 Unauthorized theme={null}
  {
    "success": false,
    "message": "Unauthorized",
    "error": {
      "code": "API_KEY_INVALID",
      "message": "Invalid or missing API key"
    },
    "timestamp": "2024-01-15T10:30:00Z"
  }
  ```
</ResponseExample>

**Common causes:**

* Missing `X-Api-Key` header
* Invalid API key format
* API key has been revoked

### 403 Forbidden

<ResponseExample>
  ```json 403 Forbidden theme={null}
  {
    "success": false,
    "message": "Forbidden",
    "error": {
      "code": "API_KEY_INVALID_SCOPE",
      "message": "Insufficient scope for this operation"
    },
    "timestamp": "2024-01-15T10:30:00Z"
  }
  ```
</ResponseExample>

**Common causes:**

* API key does not have Read scope
* User account is suspended

## Rate Limits

* **100 requests per minute** per API key
* Requires Read scope

## Next Steps

<CardGroup cols={2}>
  <Card title="Place Order" icon="arrow-right-arrow-left" href="/pro/api-reference/place-order">
    Use your balance to place trades
  </Card>

  <Card title="List Orders" icon="list" href="/pro/api-reference/list-orders">
    View your open and historical orders
  </Card>
</CardGroup>