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/Payments

Get Lithos payouts

get/paymentsapi_key

Reconstruct confirmed payouts to this client's primary miner address from the node's address index. Pagination is applied after the indexed transaction history is filtered to exact spends of the Lithos payout contract with an exact output to the primary miner address. This history is independent of the synchronization cache.

Query parameters

  • limitinteger · int32default 50

    The number of items in list to return

  • offsetinteger · int32default 0

    The offset to start the list from

Responses

200Page of confirmed payout transactionsPaymentTransaction[]▶
  • transactionIdstringrequired

    Payout transaction identifier

  • payoutUTXOstringrequired

    Identifier of the spent payout-contract box

  • amountinteger · int64required

    Amount paid to the miner in nanoERG

  • scoreinteger · int64nullable

    Score associated with this miner's NISP, when independently available. It cannot be recovered exactly from a rounded payout amount.

  • paymentHeightinteger · int32required

    Inclusion height of the payout transaction

  • blockIdstringnullable

    Id of the block processed by Lithos and associated with this reward, when known from rollup state. This is not the chain block containing the payout transaction.

  • minedBlockHeightinteger · int32nullable

    Height of the block processed by Lithos and associated with this reward, when known from rollup state.

400Malformed pagination value or other invalid requestApiError▶
  • errorintegerrequired

    Error code

  • reasonstringrequired

    Error message explaining the reason of the error

  • detailstringrequirednullable

    Detailed error description

403Missing or wrong api_keyApiError▶
  • errorintegerrequired

    Error code

  • reasonstringrequired

    Error message explaining the reason of the error

  • detailstringrequirednullable

    Detailed error description

404No confirmed Lithos payouts were found for the primary miner addressApiError▶
  • errorintegerrequired

    Error code

  • reasonstringrequired

    Error message explaining the reason of the error

  • detailstringrequirednullable

    Detailed error description

500Unexpected failure while reconstructing payment historyApiError▶
  • errorintegerrequired

    Error code

  • reasonstringrequired

    Error message explaining the reason of the error

  • detailstringrequirednullable

    Detailed error description

503The indexed node is unavailable, not current, or the bounded history scan cannot fill the pageApiError▶
  • 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

← PreviousList all pool blocksNext →Statistics overview
Request
curl -X GET "http://localhost:9000/payments" \
  -H "api_key: $LITHOS_API_KEY"
Response
[
  {
    "transactionId": "c42513da4dc695dbac3fb13482b604b289c9f1d39355e2e839899ed57780d9ab",
    "payoutUTXO": "5035b2e112b4f5b873dd3444c01df1e7e697807fd84fe96790eacb128e46428d",
    "amount": 67500000000,
    "score": 5000000,
    "paymentHeight": 47832,
    "blockId": "d5bb8d6fcb179a427e21b7ad68ec9148916aac7604f75c642acc1c3e28bd4c59",
    "minedBlockHeight": 47112
  }
]