---
title: "Update provider balances"
method: POST
path: "/provider/balances"
tags: ["Provider"]
---

# Update provider balances

`POST /provider/balances`

## Request

- Base URL: `https://api.paycrest.io/v2`
- URL: `https://api.paycrest.io/v2/provider/balances`
- Auth: API key in header `API-Key`

Provider node reports current available liquidity balances per currency.

## Request body

- object
  - `balances` object[]
    - `currency` string, required: Fiat currency code (e.g. NGN, KES)
    - `availableBalance` string, required: Available balance in fiat units

## Response `200`

Balances updated

- StandardResponse
  - `status` string
  - `message` string
  - `data` object: The actual response data (e.g., ReceiveAddressResponse, etc.)

## Other responses

- `400`: Bad request
- `401`: Unauthorized

## Changes

- **2026-11-03** `b2558cacb755`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/paycrest/apis/paycrest-aggregator-api/changes/provider/balances/post.md)

---

[API](https://skmtc.dev/paycrest/apis/paycrest-aggregator-api.md) - [All operations](https://skmtc.dev/paycrest/apis/paycrest-aggregator-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paycrest/apis/paycrest-aggregator-api/revisions/b2558cacb755?raw)
