Every LithosDex pool
/dex/poolsEvery LithosDex pool on chain, ERG/token and token/token, ERG:LIT first, then verified pools, then newest first. Anyone can create a pool. A pool on the client's verified list was checked by hand; any other pool is checked against the facts its contracts take on trust at genesis, and problems lists each one it breaks. A pool with problems can be drained: do not trade with it.
Read from an index the client rebuilds in the background as blocks arrive, so a request never waits on a scan. status is building until the first index completes. Pools named in lithosdex.pools.hidden are left out; their own routes still answer.
Responses
200The pools, as the index last read themLDPoolList▶
statusstringrequiredone ofbuildingreadyheightinteger · int32requiredThe tip the index was read at
truncatedbooleanrequiredMore pools exist than one index reads; the newest are listed.
▶
poolsLDPoolSummary[]requiredpoolNFTstringrequiredkindstringrequiredn2tis ERG against a token,t2ttoken against tokenone ofn2tt2tutxoIdstringrequiredThe pool box the index read
inclusionHeightinteger · int32required▶
tokenXLDPoolTokenrequiredOne side of a pool. A verified token's name, ticker and decimals come from the client's verified list; any other token's from the node's token index, where whoever minted the token chose them.
tokenIdstringrequiredToken id, or
ERGfor the X side of an ERG/token poolnamestringtickerstringShort symbol. Verified tokens and ERG only.
decimalsinteger · int32verifiedbooleanrequired
▶
tokenYLDPoolTokenrequiredOne side of a pool. A verified token's name, ticker and decimals come from the client's verified list; any other token's from the node's token index, where whoever minted the token chose them.
tokenIdstringrequiredToken id, or
ERGfor the X side of an ERG/token poolnamestringtickerstringShort symbol. Verified tokens and ERG only.
decimalsinteger · int32verifiedbooleanrequired
reservesXstringrequiredreservesYstringrequiredpendingXstringrequiredFees awaiting a flush to the vault
pendingYstringrequiredsupplystringrequiredShares issued
▶
feeParamsLDFeeParamsrequiredFee numerators over
feeDenom.dexFeeNumstays in the pool;ergFeeNum/tokenFeeNumare set aside for liquidity providers.dexFeeNuminteger · int64requiredergFeeNuminteger · int64requiredtokenFeeNuminteger · int64requiredfeeDenominteger · int64requiredDenominator of every numerator above
provTokensLeftstringrequiredDeposits the pool can still take, one provision token each
pricenumber · doubleUnits of Y per unit of X at display decimals. Absent when either side's decimals are unknown.
verifiedbooleanrequiredWhether the client's verified list names this pool
genesisCheckedbooleanrequiredWhether this pool's genesis was checked. False for verified pools, which are checked by hand, and while the node could not be read.
problemsstring[]requiredGenesis facts this pool breaks. Any one can let the pool be drained.
warningsstring[]requiredRisks short of that, such as too little ERG to survive storage rent.
defaultErrorApiError▶
errorintegerrequiredError code
reasonstringrequiredError message explaining the reason of the error
detailstringrequirednullableDetailed error description