api
/
UserService

Bare Bitcoin API (1.0.0)

API for interacting with Bare Bitcoin. Most endpoints require authentication. Create API keys here. Read about API authentication here.

Download OpenAPI description
openapi.json
openapi.yaml
Overview
URL https://barebitcoin.no
E-mail barebitcoin@bb.no
Languages
Servers
Prod environment
https://api.bb.no/

BitcoinTransferService

Transfer bitcoin in and out of the platform. Fetch information about past bitcoin transfers.

Operations

LedgerService

Operations

PublicService

Public endpoints that don't require authentication

Operations

TradingService

Execute and cancel orders. Fetch information about past orders.

Operations

UserService

Fetch information the authenticated user and it sub accounts.

Operations

Fetch bitcoin sub accounts

Request

Lists the bitcoin accounts for the user. Each bitcoin account has a separate balance. Every bitcoin transaction (withdrawal, deposit, trade, bonus payout) affects the balance of exactly one bitcoin account.

curl -i -X GET \
  https://api.bb.no/v1/user/bitcoin-accounts \
  -H 'x-bb-api-hmac: YOUR_API_KEY_HERE' \
  -H 'x-bb-api-key: YOUR_API_KEY_HERE' \
  -H 'x-bb-api-nonce: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json
accountsArray of objects(BitcoinAccount)
Response
application/json
{
  "accounts": [
    { … }
  ]
}

Fetch user fiat information

Request

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

curl -i -X GET \
  https://api.bb.no/v1/user/fiat-account \
  -H 'x-bb-api-hmac: YOUR_API_KEY_HERE' \
  -H 'x-bb-api-key: YOUR_API_KEY_HERE' \
  -H 'x-bb-api-nonce: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json
availableNoknumber(double)

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

pendingOrdersNoknumber(double)

The current NOK holdings that are tied up in pending orders.

Response
application/json
{
  "availableNok": 0.1,
  "pendingOrdersNok": 0.1
}