Skip to content

Bare Bitcoin API (0.0.1)

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

Download OpenAPI description
Languages
Servers
Prod environment
https://api.bb.no

BitcoinTransferService

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

Operations

PublicService

Public endpoints that don't require authentication

Operations

Request

Fetches the current BTCNOK price.

Query
amountnumber(double)

Amount NOK to trade for. If empty, defaults to 5000 NOK.

curl -i -X GET \
  'https://api.bb.no/v1/price/nok?amount=0.1'

Responses

OK

Bodyapplication/json
pricenumber(double)

The mid price.

bidnumber(double)

Current bid price, without fees.

asknumber(double)

Current ask price, without fees.

timestampstring(date-time)

The time the price was fetched.

cardobject

Effective price, when paying with card.

bankobject

Effective price, when paying with bank transfer.

Response
application/json
{ "price": 0.1, "bid": 0.1, "ask": 0.1, "timestamp": "2019-08-24T14:15:22Z", "card": { "buy": 0.1, "sell": 0.1 }, "bank": { "buy": 0.1, "sell": 0.1 } }

Request

Returns statistics about the volume of BTCNOK trades.

Query
datestring

The date to fetch the volume for. If empty, defaults to today. Format: YYYY-MM-DD

curl -i -X GET \
  'https://api.bb.no/v1/volume?date=string'

Responses

OK

Bodyapplication/json
dailyobject(VolumeStats)
monthlyobject(VolumeStats)
yearlyobject(VolumeStats)
Response
application/json
{ "daily": { "amountNok": 0.1, "amountBtc": 0.1, "buyPercentage": 0.1 }, "monthly": { "amountNok": 0.1, "amountBtc": 0.1, "buyPercentage": 0.1 }, "yearly": { "amountNok": 0.1, "amountBtc": 0.1, "buyPercentage": 0.1 } }

Request

Query
datestring

The date to fetch the volume for. If empty, defaults to today. Format: YYYY-MM-DD

curl -i -X GET \
  'https://api.bb.no/v1/volume/historic?date=string'

Responses

OK

Bodyapplication/json
dailyVolumeArray of objects(VolumeHistoricResponse_DailyVolume)
shareOfTotalVolumeobject

Each market's share of the total volume for the period in question.

Response
application/json
{ "dailyVolume": [ { … } ], "shareOfTotalVolume": { "property1": 0.1, "property2": 0.1 } }
Operations

TradingService

Execute and cancel orders. Fetch information about past orders.

Operations

UserService

Fetch information the authenticated user and its bitcoin accounts.

Operations