List Prices

GET https://api.lirium-sandbox.com/v1/prices

Current buy and sell prices of every currency Lirium offers

Lists the price at which every base currency can currently be bought (ask) and sold (bid), against each of the quote currencies it is offered in.

The response also names and types every currency it mentions, so you can render the whole listing without calling any other endpoint.

📘

Public endpoint

GET /prices takes no Authorization header, and the prices it serves are neither partner nor customer specific. It is safe to call it from a public price ticker.

Response

Field	Type	Description
quote_currencies	object	The currencies prices are quoted in, keyed by currency code.
base_currencies	object	The currencies that are priced, keyed by currency code. Holds exactly the keys of prices.
prices	object	Prices keyed by base currency and then by quote currency.
updated_at	string	When the snapshot was built, ISO 8601.

quote_currencies

Field	Type	Description	Example
name	string	Display name of the currency.	"US Dollar"
decimal_places	integer	Decimals to format an amount in this currency with, when it is the quote side of a price. Never below 4, so it can be higher than the decimals the currency itself uses.	4

base_currencies

Field	Type	Description	Example
name	string	Display name of the currency.	"Apple xStock"
type	string	Asset type: cryptocurrency, stablecoin, xstock or nav. Omitted for the currencies Lirium has not typed.	"xstock"
multiplier	string	Tokens of this xStock that represent one share. Present only on xstock currencies.	"1.0026642075893797"

prices

Each entry under a base currency holds the two sides of the price, as strings:

Field	Type	Description
bid	string	Price the customer sells one unit of the base currency at. Absent when the base currency cannot be sold.
ask	string	Price the customer buys one unit of the base currency at. Absent when the base currency cannot be bought.

A pair Lirium cannot price at the moment is absent from the map, so read prices defensively rather than assuming every base currency is offered against every quote currency.

Example Response

JSON

{
  "quote_currencies": {
    "USD": { "name": "US Dollar", "decimal_places": 4 },
    "ARS": { "name": "Argentine Peso", "decimal_places": 4 },
    "BTC": { "name": "Bitcoin", "decimal_places": 8 }
  },
  "base_currencies": {
    "BTC": { "name": "Bitcoin", "type": "cryptocurrency" },
    "USDC": { "name": "USD Coin", "type": "stablecoin" },
    "AAPLx": {
      "name": "Apple xStock",
      "type": "xstock",
      "multiplier": "1.0026642075893797"
    }
  },
  "prices": {
    "BTC": {
      "USD": { "bid": "60000.0000", "ask": "61500.0000" },
      "ARS": { "bid": "60000000.0000", "ask": "63345000.0000" }
    },
    "USDC": {
      "USD": { "bid": "0.9980", "ask": "1.0020" },
      "BTC": { "bid": "0.00001623", "ask": "0.00001670" }
    },
    "AAPLx": {
      "USD": { "bid": "245.5000", "ask": "252.3000" },
      "BTC": { "bid": "0.00399186", "ask": "0.00420500" }
    }
  },
  "updated_at": "2026-09-22T14:24:28.458787+00:00"
}

xStocks

An xStock is priced as a base currency only, never as a quote currency, so it appears in base_currencies and as a key of prices, but never in quote_currencies.

Its multiplier is the number of tokens that represent one share. It starts at 1 and grows as the issuer distributes stock dividends, so use it to convert between tokens and shares when you display a position:

shares = tokens / multiplier

The multiplier is omitted while Lirium has not loaded one for that xStock yet — treat its absence as "not available", not as 1.

🚧

Prices are indicative

These prices already include Lirium's spread, but they are a snapshot: the price an order actually executes at is the one quoted on that order. Use updated_at to decide when to refresh, and quote the customer through Create Order before confirming.