Lithos Client API

Synchronization status and capability availability for the Lithos client

Usable, canonically committed blocks currently being processed by Lithos contracts

Confirmed Lithos payouts to this client's primary miner address

Mining, payment, collateral and client activity numbers for dashboards and graphs. Collection runs in the background, so a request never makes the client scan the node. Only /stats/local needs an api_key; the rest are open reads. Nothing here is cached.

Every response carries a status. Only ready means the numbers have caught up to the chain tip — show anything else as loading or stale.

All amounts and work totals are exact decimal strings, not JSON numbers. ERG amounts are nanoERG (1 ERG = 1,000,000,000); LIT amounts are base units (9 decimals); timestamps are Unix milliseconds. History is kept for a configured number of days, not forever.

Stats and participation for the collateral market: the queue, the active set, emission state, and joining the queue.

All amounts are decimal strings, not JSON numbers. ERG amounts are nanoERG; LIT amounts are base units (9 decimals).

Swap, provide liquidity and collect fees on the LithosDex pool.

Swaps, deposits and redemptions can be placed as orders under /dex/orders, which any miner fills for the order's executor fee, or sent directly, spending the pool at once. Prefer orders: a miner filling orders may replace an unconfirmed direct spend of the pool, which then has to be resent.

All amounts are decimal strings, not JSON numbers. A 409 means a box you quoted against has moved: re-read, re-quote and resend.

Balances and lending status for the client's own wallet. Requires an api_key.

All amounts are decimal strings, not JSON numbers. ERG amounts are nanoERG; LIT amounts are base units (9 decimals).

Information about the local stratum and mining process