Skip to content

GET /currencies

Method: GET
URL: https://pos.b4bit.com/api/v1/currencies
Authentication: X-Device-Id header — see Authentication.

Parameters

None.

Examples

curl -H "X-Device-Id: $B4BIT_API_KEY" \
https://pos.b4bit.com/api/v1/currencies

import { fetch } from 'undici';

const res = await fetch('https://pos.b4bit.com/api/v1/currencies', {
headers: { 'X-Device-Id': process.env.B4BIT_API_KEY },
});
const currencies = await res.json();

import os, requests

r = requests.get(
  'https://pos.b4bit.com/api/v1/currencies',
  headers={'X-Device-Id': os.environ['B4BIT_API_KEY']},
)
currencies = r.json()

$ch = curl_init('https://pos.b4bit.com/api/v1/currencies');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-Device-Id: ' . getenv('B4BIT_API_KEY')]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$currencies = json_decode(curl_exec($ch), true);

`200` response

[
  {
    "symbol": "USDC_POLYGON_NXTB",
    "name": "USD Coin USDC",
    "min_amount": "1.00",
    "max_amount": null,
    "image": "https://pos.b4bit.com/media/crytocurrencies/...",
    "blockchain": "MATIC_POLYGON"
  },
  {
    "symbol": "TRX_USDC_6NU3",
    "name": "USD Coin USDC",
    "min_amount": "10.00",
    "max_amount": "1200.00",
    "image": "https://pos.b4bit.com/media/crytocurrencies/...",
    "blockchain": "TRX"
  }
]

Fields

Field	Type	Description
`symbol`	string	Granular per (currency, network). Use as `input_currency` on `POST /orders/`.
`name`	string	Friendly crypto name.
`min_amount`	string (decimal)	Minimum amount per payment (in fiat).
`max_amount`	string (decimal) \| null	Maximum amount per payment. `null` = no limit.
`image`	string (URL)	Crypto icon.
`blockchain`	string	Blockchain network code.

Errors

403 — Missing or invalid X-Device-Id.
500 — Internal error. Retry with backoff.