LithosDocs
ProtocolPayoutsTokenStatsDocs
Start mining
Documentation home
Protocol
  • Lithos Protocol
  • LFSM
    • Rollups
    • NISPs
    • Emissions
    • Mining on Lithos
    • Candidate building
    • Ergo Voting
  • LithosDex
    • Choosing a pool
    • Trading with orders
    • Providing liquidity
    • Creating a pool
    • Difficulty forwards
    • SigmaFi bonds
Run Lithos
  • Startup guide
    • Setting up an Ergo 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
    • Renting hashrate into Lithos
    • Checking your wallet
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
    • getThis wallet's lending earnings
    • getLocal mining activity
    • getCollateral market snapshot
    • getList queue boxes
    • getList the active set
    • getPermit price history
    • getYour lending status
    • postQuote joining the queue
    • postJoin the collateral queue
    • getLithosDex pool state
    • getEvery LithosDex pool
    • getOne LithosDex pool and its vault
    • getList your outstanding orders on any pool
    • postQuote a direct swap on any pool
    • postSwap directly on any pool
    • postQuote a direct deposit on any pool
    • postDeposit directly on any pool
    • postQuote a direct redemption on any pool
    • postRedeem a provision directly on any pool
    • getList your provisions on any pool
    • postClaim a provision's fees on any pool
    • postCheck a flush on any pool
    • postFlush any pool
    • getA verified pool's price history
    • getA verified pool's fee history
    • getA verified pool's recent activity
    • getA provision's fee history on a verified pool
    • postQuote a new LithosDex pool
    • postCreate a LithosDex pool
    • postQuote a swap order on any pool
    • postPlace a swap order on any pool
    • postQuote a deposit order on any pool
    • postPlace a deposit order on any pool
    • postQuote a redeem order on any pool
    • postPlace a redeem order on any pool
    • 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
    • postLook up provision NFTs
    • 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
    • getDifficulty accumulator and the next epoch's difficulty
    • getList open offers
    • postCreate an offer
    • postQuote an offer
    • postQuote filling an offer
    • postFill an offer
    • postQuote cancelling an offer
    • postCancel an offer
    • getThe whole market
    • getYour settled positions and closed offers
    • getList your positions and offers
    • postQuote settling a position
    • postSettle a position
    • getList open orders
    • postCreate an order
    • postQuote an order
    • postQuote cancelling an order
    • postCancel an order
    • postQuote filling an order
    • postFill an order
    • getList live bonds
    • postQuote repaying a bond
    • postRepay a bond
    • postQuote liquidating a bond
    • postLiquidate a bond
    • postQuote a claim
    • postClaim a settled bond
    • postLook up bond assets
    • getThis wallet in SigmaFi
    • getList configured oracle feeds
    • getCurrent oracle state and recent confirmed history
    • getWallet balances
    • getYour block rewards
    • postClaim unlocked block rewards
    • getVerified tokens
    • getArb stake
    • postReclaim the arb stake
    • 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
  • Difficulty forwards
  • Client API
  • Failure modes
Network
  • Live stats
  • Public stats API
  • Ergo Platform↗
  • SOAT Miner↗
Community
  • Telegram↗
  • X / Twitter↗
  • GitHub↗
Lithos
© 2026 Lithos Protocol. The Lithos client, its contracts and Lithos Launcher are open source under CC0.λίθος — stone
Docs/Client API/SigmaFi Bonds

List open orders

get/sigmafi/orders

Borrowers' orders waiting for a lender, newest first. Unconfirmed orders are included and orders already being spent are not. collateral keeps orders whose collateral holds that token, or any ERG with erg; loan keeps orders borrowing that token, or ERG with erg. Each order says why this client would not fill it, when it would not.

Query parameters

  • offsetintegerdefault 0
  • limitintegerdefault 10
  • collateralstring

    A token id the collateral must hold, or erg for collateral with any ERG.

  • loanstring

    The token lent, or erg for ERG loans.

Responses

200One page of open ordersSFOrderBook▶
  • heightintegerrequired
  • ▶
    ordersSFOrderView[]required
    • boxIdstringrequired
    • ▶
      termsSFTermsrequired

      A bond's terms, as its order states them and the bond carries them.

      • kindstringrequired

        The bond's kind. Every SigmaFi V2 bond is zero-coupon.

      • principalNanoErgsstring

        Agreed nanoERG lent; for a token loan, the principal box's floor. Read directly from a bond's R6.

      • ▶
        principalTokenSFTokenAmount
        • tokenIdstringrequired
        • amountstringrequired

          Base units.

      • repaymentstringrequired

        What the borrower repays, in nanoERG or in base units of repayToken.

      • repayTokenstring

        The token a token loan is repaid in. Absent when repaid in ERG.

      • collateralNanoErgsstringrequired

        Borrower collateral nanoERG, excluding the lender-funded reserve.

      • ▶
        collateralTokensSFTokenAmount[]required
        • tokenIdstringrequired
        • amountstringrequired

          Base units.

      • maturityHeightinteger · int64

        Repayment is open strictly below it. Absent for an on-close order until it is filled.

      • durationBlocksinteger · int64

        An on-close order's term, counted from its fill.

      • batchingFeestringrequired

        Lender-funded reserve selected on fill; zero on unfilled orders. Refunded on repayment.

      • liquidationstring

        The liquidation script's name. Absent when this client does not know it.

      • liquidationHashstringrequired
    • borrowerstring

      The address the principal goes to, when this client can tell.

    • minebooleanrequired
    • refusalstring

      Why this client would not fill it. Absent when it would.

    • creationHeightintegerrequired
  • totalintegerrequired
  • truncatedbooleanrequired

    The scan stopped at its cap, so older orders were not read.

400A malformed field, or terms no contract or shipped client accepts.ApiError▶
  • errorintegerrequired

    Error code

  • reasonstringrequired

    Error message explaining the reason of the error

  • detailstringrequirednullable

    Detailed error description

503Node or index unavailable. Never returns a partial answer.ApiError▶
  • errorintegerrequired

    Error code

  • reasonstringrequired

    Error message explaining the reason of the error

  • detailstringrequirednullable

    Detailed error description

← PreviousSettle a positionNext →Create an order
Request
curl -X GET "http://localhost:9000/sigmafi/orders"
Response
{
  "height": 0,
  "orders": [
    {
      "boxId": "string",
      "terms": {
        "kind": "string",
        "principalNanoErgs": "string",
        "principalToken": {
          "tokenId": "string",
          "amount": "string"
        },
        "repayment": "string",
        "repayToken": "string",
        "collateralNanoErgs": "string",
        "collateralTokens": [
          {
            "tokenId": "string",
            "amount": "string"
          }
        ],
        "maturityHeight": 0,
        "durationBlocks": 0,
        "batchingFee": "string",
        "liquidation": "string",
        "liquidationHash": "string"
      },
      "borrower": "string",
      "mine": true,
      "refusal": "string",
      "creationHeight": 0
    }
  ],
  "total": 0,
  "truncated": true
}