Skip to main content
GET
/
v1
/
merchant
/
balance
Get merchant balance
curl --request GET \
  --url https://api.daya.co/v1/merchant/balance \
  --header 'X-Api-Key: <x-api-key>'
{
  "data": {
    "collection_balance_usd": "500.1234",
    "withdrawal_balance_usd": "100.1234"
  }
}

Overview

Returns your current merchant USD balances. The response includes separate collection_balance_usd and withdrawal_balance_usd fields. The collection balance accumulates from funding account deposits and USD virtual account deposits, and can be transferred to the withdrawal balance via the balance transfer endpoint. The withdrawal balance is used for transfers and on-chain withdrawals.

Authentication

X-Api-Key
string
required
Your merchant API key

Request Examples

curl --request GET \
  --url https://api.daya.co/v1/merchant/balance \
  --header 'X-Api-Key: YOUR_API_KEY'

Response

data
object
Current merchant balance details.

Success Response

{
  "data": {
    "collection_balance_usd": "500.1234",
    "withdrawal_balance_usd": "100.1234"
  }
}

Error Responses

This endpoint may return:
  • 401: Unauthorized
  • 500: Internal server error

Next Steps

Transfer Balance

Move funds from collection to withdrawal balance

Withdraw Balance

Transfer withdrawal balance to an on-chain address

Merchant Funding

View funding instructions to top up your balance