API reference / Accounts and access

Fiat account

Fetches the fiat account. The fiat account for a user holds their NOK balance. Every user has exactly one fiat account. Other sub-accounts for a user only pertains to bitcoin holdings.

View Markdown

GET https://api.bb.no/v1/user/fiat-account

Authentication

API key

Send x-bb-api-key. No nonce or signature is required.

Authentication guide →

Parameters

No path or query parameters.

Responses

200 · OK

application/json

GetFiatAccountResponse

Show fields

availableNoknumber · double

The current NOK holdings that can be used for trading or withdrawals.

Example: 12500.5

Request example

GET/v1/user/fiat-accountAPI key

curl -X GET \
  https://api.bb.no/v1/user/fiat-account \
  -H "x-bb-api-key: $BB_API_KEY"

Replace example identifiers and set credentials in environment variables before running.

Response example

Response200

{
  "availableNok": 12500.5
}