api
/
PublicService

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

Fetch BTCNOK

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

The prices a user can expect to pay for a given amount of BTCNOK, with a given payment method.

bankobject

The prices a user can expect to pay for a given amount of BTCNOK, with a given payment method.

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
  }
}

Fetch volume statistics

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
  }
}

TradingService

Execute and cancel orders. Fetch information about past orders.

Operations

UserService

Fetch information the authenticated user and it sub accounts.

Operations