StatusSupportGet API keys
Market

Get ticker data for one asset

GET/v3/currency/ticker/{symbol}

Returns the price and market statistics of one crypto asset in a chosen currency.

The response is a two-level map: the outer key is rateCurrency (or USD when it is omitted) and the inner key is the path symbol. The array under it depends on interval:

  • Without interval, one entry with the live quote and no interval field.
  • With interval, one entry per requested interval holding the price one interval ago, and no live quote. Request the endpoint twice if you need both.

Market statistics (marketCap, totalVolume, fullyDilutedMarketCap, maxSupply, totalSupply) are always the current values, converted to rateCurrency, and are omitted when the service has no data for them.

The service does not reject unknown symbols. An unknown symbol returns [null] (without interval) or [] (with it), and an unknown rateCurrency returns price: "0".

No authentication is required.

Path Parameters

symbol*string

Crypto asset symbol, such as BTC. Case-sensitive.

Match^[A-Z0-9]{1,10}$

Query Parameters

rateCurrency?string

Currency to quote prices and market statistics in, fiat or crypto (for example EUR or USDT). Defaults to USD.

Match^[A-Z0-9]{2,10}$
interval?array<>

Historical points to return instead of the live quote. Repeat the parameter or pass a comma-separated list; entries come back in the order requested.

extended?boolean
Deprecated

Accepted for compatibility but ignored: market statistics are always included when available.

Response Body

application/json

application/json

Get ticker data for one asset
curl --request GET \  --url 'https://gateway.bit2me.com/v3/currency/ticker/BTC?rateCurrency=EUR&interval=one_day&extended=true'
Example1 of 2
{  "EUR": {    "BTC": [      {        "fullyDilutedMarketCap": "1361236321483.54084",        "interval": "one_day",        "marketCap": "1361235304575.321375",        "maxSupply": "21000000",        "price": "66236.59258800412841517804095635",        "time": 1788357343771,        "totalSupply": "20079084",        "totalVolume": "22245259011.29535"      }    ]  }}

Get historic price chart GET

Returns a time series for a currency pair, ready to draw a price chart. Each row is `[time, baseRate, quoteRate]`: Unix epoch milliseconds, then the rate of each currency against the US dollar (units per 1 USD, as in `GET /v1/currency/rate`). The price of the base in the quote currency is `quoteRate / baseRate`. Either rate is `null` when there is no data at that timestamp; skip those rows instead of plotting zero. `temporality` selects both the time range and the spacing between points. Rows are ordered oldest first. `all-time` is not available between two fiat currencies and returns a `400` with a different body shape (`errorCode` instead of `statusCode`). No authentication is required.

Get the amount required to open a loan at 50% LTV GET

Returns the missing amount so a new loan would open at the creation LTV (`0.50`). Send exactly one of `guaranteeAmount` or `loanAmount`; the other is derived from current prices. Sending both, or neither, is rejected. Also returns both amounts in `userCurrency` and the base APR of `loanCurrency` before the user's discounts. `ltv` is a ratio (`0.50` is 50 %). Nothing is created or reserved. Use these currencies and amounts to preview the contract with `POST /v1/loan/pre-contract` (optional) and to open the loan with `POST /v1/loan/orders`.