LithosDocs
ProtocolPayoutsTokenStatsDocs
Start mining
Documentation home
Protocol
  • Lithos Protocol
  • LFSM
    • Rollups
    • NISPs
    • Emissions
    • Mining on Lithos
    • Candidate building
    • Ergo Voting
  • LithosDex
    • Trading with orders
    • Providing liquidity
Run Lithos
  • Startup guide
    • Setting up an Ergo testnet node
  • Configuration
    • Node connection and security
    • Stratum and difficulty
    • Block packages
    • Batching and orders
    • Collateral and emission
    • Wallet and consolidation
    • Statistics and web panels
    • Synchronization and storage
    • Tasks and dispatchers
    • Failure modes
    • Reporting issues
Client API
  • Overview
    • getLithos client information
    • getList UTXO ids for blocks
    • getUTXO ids by block height
    • getBlock info by UTXO id
    • postBlock info for multiple UTXO ids
    • getGet a block's miner set
    • getList all pool blocks
    • getGet Lithos payouts
    • getStatistics overview
    • getMining and payment totals
    • getMining statistics by hour or day
    • getEstimate Lithos hashrate
    • getNetwork difficulty by epoch
    • getThis client's own hashrate
    • getThis client's hashrate over time
    • getThis client's payouts and claims
    • getCollateral inventory
    • getLocal mining activity
    • getCollateral market snapshot
    • getList queue boxes
    • getList the active set
    • getPermit price history
    • getYour locked block rewards
    • postClaim unlocked block rewards
    • postQuote joining the queue
    • postJoin the collateral queue
    • getLithosDex pool state
    • getLithosDex fee vault state
    • getList your outstanding orders
    • postQuote a swap order
    • postPlace a swap order
    • postQuote a deposit order
    • postPlace a deposit order
    • postQuote a redeem order
    • postPlace a redeem order
    • postCancel an order
    • postQuote a swap
    • postQuote a swap by desired output
    • postExecute a swap
    • postQuote a liquidity deposit
    • postDeposit liquidity
    • postQuote a liquidity redemption
    • postRedeem liquidity
    • getList liquidity provisions
    • postClaim settled fees for a provision
    • postQuote a provision resize
    • postResize a provision
    • postCheck a pending fee flush
    • postFlush pending fees to the vault
    • getPool-wide fee history
    • getPool price history
    • getRecent pool activity
    • getFee history for one provision
    • getWallet balances and lending status
    • getGet Stratum information
    • getGet candidate settings
    • getGet difficulty commitment
    • postCommit a difficulty
    • getGet best NISP at height
Lithos

A decentralized mining pool protocol on Ergo. Miners build their own blocks; contracts pay them for proven work.

Live on Ergo mainnet
Protocol
  • How Lithos works
  • Mining on Lithos
  • NISPs
  • Emissions
  • LFSM contracts
Run Lithos
  • Startup guide
  • Configuration
  • LithosDex
  • Client API
  • Failure modes
Network
  • Live stats
  • Public stats API
  • Ergo Platform↗
  • SOAT Miner↗
Community
  • Telegram↗
  • X / Twitter↗
  • GitHub↗
Lithos
© 2026 Lithos Protocol. Open source under the MIT licence.λίθος — stone
Docs/Client API/Collateral Market

Collateral market snapshot

get/collateral/market

Current queue and active-set sizes, total ERG and LIT locked, the permit a new join pays, and where the emission schedule currently sits.

Responses

200Current market stateCollateralMarketInfo▶

One snapshot of the collateral market. ERG amounts are nanoERG decimal strings; permit and emission amounts are LIT base units as decimal strings.

  • syncHeightinteger · int32required

    Chain height this snapshot was taken at

  • activationCounterinteger · int32required

    Activations paid so far — the emission box's position in the schedule

  • queueHeadinteger · int64required

    Position of the queue box that activates next

  • queueTailinteger · int64required

    Position the next join will take

  • queueLengthinteger · int64required

    Positions waiting — queueTail less queueHead

  • activeSetSizeinteger · int32required

    Distinct lender keys currently holding a live collateral box

  • activeSetMaxinteger · int32required

    Slots the active set can hold. Fixed by contract.

  • bootstrappingbooleanrequired

    True while the set is still filling and an Activate needs no retirement

  • proofsOfSpendAvailableinteger · int32required

    Retirements usable next block — how many queued positions could activate now

  • queuedNanoErgsstringrequired

    Total principal sitting in the queue. Decimal string.

  • activeNanoErgsstringrequired

    Total value across the live collateral boxes. Decimal string.

  • permitLitLockedstringrequired

    LIT locked as permits across the queue and the active set. Decimal string.

  • principalNanoErgsstringrequired

    What one join posts — block reward less fee cap plus dust. Fixed by contract. Decimal string.

  • currentPermitLitstringrequired

    The permit the NEXT join pays at this backlog, before any escalation. Decimal string.

  • permitFloorLitstringrequired

    Permit at an empty queue, from the config box. Decimal string.

  • permitCeilingLitstringrequired

    The most a permit can ever be. Decimal string.

  • permitSlopeLitPerBoxstringrequired

    Permit added per queued box. Decimal string.

  • emissionPhasestringrequired

    Public emission rate phase. DECAYING drops every two epochs; STEPPED is the two fixed intermediate rates; FLAT_50 is the final constant rate; ENDED means the schedule is complete.

    one ofDECAYINGSTEPPEDFLAT_50ENDED
  • foundersActivebooleanrequired

    True while the private founder allocation is still being paid alongside the public rate

  • currentEpochinteger · int32required

    Schedule epoch of the last activation

  • nextPhaseChangeHeightinteger · int32nullable

    Height of the next rate change or epoch boundary. Null once ENDED.

  • emissionRatePublicLitstringrequired

    Public LIT per activation at this point in the schedule. Decimal string.

  • emissionRatePrivateLitstringrequired

    Founder-side LIT per activation, zero once that period ends. Decimal string.

  • emissionRateTotalLitstringrequired

    What one Activate actually emits, capped by what the box still holds. Decimal string.

  • scheduleEndsAtHeightinteger · int32required

    Activation count the schedule ends at (2,825,000)

503Node unavailable. Retry.ApiError▶
  • errorintegerrequired

    Error code

  • reasonstringrequired

    Error message explaining the reason of the error

  • detailstringrequirednullable

    Detailed error description

defaultErrorApiError▶
  • errorintegerrequired

    Error code

  • reasonstringrequired

    Error message explaining the reason of the error

  • detailstringrequirednullable

    Detailed error description

← PreviousLocal mining activityNext →List queue boxes
Request
curl -X GET "http://localhost:9000/collateral/market"
Response
{
  "syncHeight": 484719,
  "activationCounter": 1234,
  "queueHead": 410,
  "queueTail": 1247,
  "queueLength": 837,
  "activeSetSize": 97,
  "activeSetMax": 100,
  "bootstrapping": false,
  "proofsOfSpendAvailable": 2,
  "queuedNanoErgs": "2439835500000",
  "activeNanoErgs": "282755000000",
  "permitLitLocked": "12840000000",
  "principalNanoErgs": "2915000000",
  "currentPermitLit": "19370000000",
  "permitFloorLit": "1000000000000",
  "permitCeilingLit": "30000000000000",
  "permitSlopeLitPerBox": "10000000000",
  "emissionPhase": "DECAYING",
  "foundersActive": true,
  "currentEpoch": 0,
  "nextPhaseChangeHeight": 250000,
  "emissionRatePublicLit": "500000000000",
  "emissionRatePrivateLit": "140000000000",
  "emissionRateTotalLit": "640000000000",
  "scheduleEndsAtHeight": 2825000
}