curl "https://api.liddie.io/invoice/exampleslug1/currency-options"
// Public endpoint — no credentials required, safe from the payer's browser.
const res = await fetch(
'https://api.liddie.io/invoice/exampleslug1/currency-options'
);
const { ok, data } = await res.json();
if (ok) console.log(data.options);
{
"ok": true,
"data": {
"fiatAmount": 20,
"fiatCurrency": "USD",
"options": [
{ "currency": "LTC", "minUsd": 5, "available": true },
{ "currency": "USDT_TRC20", "minUsd": 25, "available": false }
]
}
}
Public checkout
List currency options
List the crypto currencies a payer can choose for an AWAITING_CURRENCY Liddie invoice, with per-currency USD minimums and availability.
GET
/
invoice
/
{invoiceId}
/
currency-options
curl "https://api.liddie.io/invoice/exampleslug1/currency-options"
// Public endpoint — no credentials required, safe from the payer's browser.
const res = await fetch(
'https://api.liddie.io/invoice/exampleslug1/currency-options'
);
const { ok, data } = await res.json();
if (ok) console.log(data.options);
{
"ok": true,
"data": {
"fiatAmount": 20,
"fiatCurrency": "USD",
"options": [
{ "currency": "LTC", "minUsd": 5, "available": true },
{ "currency": "USDT_TRC20", "minUsd": 25, "available": false }
]
}
}
Lists which currencies the payer may choose for an
Once the payer picks a currency, lock it in with Select pay currency.
AWAITING_CURRENCY invoice — one created without a currency. This powers the hosted invoice page, and it’s safe to call from the payer’s browser if you’re building a custom checkout UI. All data is redacted — no fees, no merchant internals.
Authorization
None — this endpoint is public. It only accepts the public invoice id (the last segment ofinvoiceUrl, e.g. exampleslug1); raw 24-hex payment ids are rejected so payments can’t be enumerated. Rate limit: 30/min.
Path parameters
string
required
The public invoice id — the last segment of the payment’s
invoiceUrl. Raw 24-hex payment ids are rejected.curl "https://api.liddie.io/invoice/exampleslug1/currency-options"
// Public endpoint — no credentials required, safe from the payer's browser.
const res = await fetch(
'https://api.liddie.io/invoice/exampleslug1/currency-options'
);
const { ok, data } = await res.json();
if (ok) console.log(data.options);
{
"ok": true,
"data": {
"fiatAmount": 20,
"fiatCurrency": "USD",
"options": [
{ "currency": "LTC", "minUsd": 5, "available": true },
{ "currency": "USDT_TRC20", "minUsd": 25, "available": false }
]
}
}
Render options with
available: false as disabled in a custom checkout UI. This usually means the invoice amount is below that currency’s USD minimum, but the option also fails closed — available: false — whenever the currency or the fiat→USD rate can’t be priced right now. Treat it simply as “not selectable”, not necessarily as “below minimum”.Response
boolean
true on success.object
Show properties
Show properties
number
The fiat price of the invoice.
string
The fiat currency of the price (e.g.
USD).array
One entry per selectable currency.
Show option fields
Show option fields
string
Currency ticker (e.g.
LTC, USDT_TRC20).number | null
That currency’s minimum order value in USD, or
null when the minimum can’t be priced right now.boolean
false when the invoice amount is below that currency’s minimum ($20 is below $25 for USDT_TRC20 in the example above) — or when the currency or the fiat→USD rate is temporarily unpriceable, in which case the option fails closed independently of the amount. (minUsd is null only in the narrower case where that currency’s own minimum can’t be priced; a missing fiat→USD rate still returns a numeric minUsd with available: false.)See also
- Select pay currency — the next step: lock the chosen currency and get the deposit address.
- Get invoice status — poll payment progress after the currency is locked.
- Cancel invoice (payer) — let the payer abandon the invoice instead of choosing a currency.