curl https://api.liddie.io/api/v1/min-orders/BTC
// Public route — no Authorization header needed
const res = await fetch('https://api.liddie.io/api/v1/min-orders/BTC')
const { ok, data } = await res.json()
// data: a bare object for the requested currency
{ "ok": true, "data": { "currency": "BTC", "minAmountCrypto": 0.0002508, "minAmountUsd": 15.62, "feeBps": 40 } }
Currencies & wallets
Get minimum for a currency
Check the minimum order amount for a single currency on Liddie, in crypto units and USD — public, with an optional feeBps fee-tier preview.
GET
/
api
/
v1
/
min-orders
/
{currency}
curl https://api.liddie.io/api/v1/min-orders/BTC
// Public route — no Authorization header needed
const res = await fetch('https://api.liddie.io/api/v1/min-orders/BTC')
const { ok, data } = await res.json()
// data: a bare object for the requested currency
{ "ok": true, "data": { "currency": "BTC", "minAmountCrypto": 0.0002508, "minAmountUsd": 15.62, "feeBps": 40 } }
Check the minimum order amount for one currency. Unlike GET /api/v1/min-orders (which returns an array), this variant returns a bare object in
data.
A
POST /api/v1/payments whose fiat amount is below minAmountUsd for the chosen currency fails with the generic 400 {"error":"Payment creation failed"} — check minimums first when charging small amounts. Minimums vary a lot by chain (e.g. ~5onDOGE/LTCvs 25 on USDT_TRC20) because they track each network’s settlement cost (the network fee to move received funds to storage).Authorization
None — this route is public.curl https://api.liddie.io/api/v1/min-orders/BTC
// Public route — no Authorization header needed
const res = await fetch('https://api.liddie.io/api/v1/min-orders/BTC')
const { ok, data } = await res.json()
// data: a bare object for the requested currency
{ "ok": true, "data": { "currency": "BTC", "minAmountCrypto": 0.0002508, "minAmountUsd": 15.62, "feeBps": 40 } }
Parameters
string
required
Currency ticker (e.g.
BTC). Unknown or unavailable values return the 400 errors below.integer
Optional — preview the minimum under a different fee tier. Parsed as an integer clamped to
[1, 5000]; anything malformed or out of range silently falls back to 40.On a custom fee tier? Pass
feeBps to preview the minimum that actually applies to you — the default shown is computed for 40 bps, and malformed or out-of-range values silently fall back to 40.Response fields
string
Currency ticker.
number
Minimum order amount in the crypto currency.
number
Minimum order amount in USD.
number
The fee tier (basis points) the minimum was computed for.
Errors
| Status | Body | Why |
|---|---|---|
| 400 | {"ok":false,"error":{"code":"INVALID_CURRENCY", ...}} | Invalid currency. |
| 400 | {"ok":false,"error":{"code":"CURRENCY_NOT_AVAILABLE", ...}} | Currency not available. |
See also
- List minimum order amounts: the all-currencies variant, which returns an array in
data. - Create a payment: the endpoint this minimum gates — validate the amount before calling it.
- List currencies: which currencies your credential can actually charge in.