Exchange Rates

BitSV gets exchange rate data from trusted third-party APIs. Specifically, it can access:

RatesAPI

Core operations use RatesAPI. For each method, it polls a service and if an error occurs it tries another.

You will likely never use this directly.

Currency to Satoshi

BitSV exposes 2 ways to convert a given amount of currency to the equivalent number of satoshi: currency_to_satoshi() and currency_to_satoshi_cached(). The latter function will cache results for 1 minute by default.

BitSV uses currency_to_satoshi_cached() in transactions to convert the amount in each output to spendable satoshi.

To illustrate, here is how your outputs in (destination, amount, currency) format are converted to (destination, satoshi) format for spending during transactions:

>>> from bitsv.network import currency_to_satoshi_cached
>>>
>>> ...
>>> for i, output in enumerate(outputs):
...     dest, amount, currency = output
...     outputs[i] = (dest, currency_to_satoshi_cached(amount, currency))

Satoshi to Currency

Converting satoshi to another currency as a formatted string can be done using satoshi_to_currency() or satoshi_to_currency_cached(). The result will be rounded down to the proper number of decimal places for each currency.

>>> from bitsv.network import satoshi_to_currency_cached
>>>
>>> satoshi_to_currency_cached(56789, 'usd')
'0.59'
>>> satoshi_to_currency_cached('56789', 'jpy')
'82'

Supported Currencies

These are all the currencies currently supported by BitSV. Note that converting satoshi to itself, ubsv, mbsv, or bsv never requires exchange rate data and therefore no network calls are needed.

>>> from bitsv import SUPPORTED_CURRENCIES
>>> print(SUPPORTED_CURRENCIES)

Code

Currency

satoshi

Satoshi

ubsv

Microbitcoincash

mbsv

Millibitcoincash

bsv

BitSV

usd

United States Dollar

eur

Eurozone Euro

gbp

Pound Sterling

jpy

Japanese Yen

cny

Chinese Yuan

cad

Canadian Dollar

aud

Australian Dollar

nzd

New Zealand Dollar

rub

Russian Ruble

brl

Brazilian Real

chf

Swiss Franc

sek

Swedish Krona

dkk

Danish Krone

isk

Icelandic Krona

pln

Polish Zloty

hkd

Hong Kong Dollar

krw

South Korean Won

sgd

Singapore Dollar

thb

Thai Baht

twd

New Taiwan Dollar

clp

Chilean Peso

Unsupported Currencies

If you need to use currencies in your Transactions that BitSV does not support, convert it yourself to satoshi, ubsv, mbsv, or bsv as these are supported natively.