Libre

Showing 25 of 28 from the live probe.

• Get Chain Info

  Chain id, head block and time for the selected network.

• Get Account

  Balances (BTC, USDT, LIBRE, TPF, CBTC), permissions, resources, and whether the account key is on the Ill Bloom affected-set (compromised) list. Refuse to operate from an account with affected_set=true; if affected_set_checked=false the gate was unavailable and affected_set=false means unknown, not safe.

• Get Deposit Address

  The account's personal BTC deposit (bridge peg-in) address. BTC sent here arrives as BTC on Libre after confirmation.

• Get Table Rows

  Raw get_table_rows escape hatch for any Libre contract table.

• Get Orderbook

  dex.libre orderbook for a pair: bids/asks sorted best-first, best prices and spread. truncated:true means the book exceeded the 500-row page read and the depth shown is partial.

• Get Orders

  Open dex.libre orders for an account (optionally one pair). truncated:true means a book exceeded the 500-row page read and orders may be missing.

• Get Trades

  Recent dex.libre trades for a pair, newest first. truncated:true means the history exceeded the 500-row page read, so older trades for this pair are not included.

• Get Pool Stats

  Lending pool state (available/outstanding USDT per pool), interest-rate curve config, and oracle BTC/USD.

• Get Loans

  Active and queued loans (optionally one account); include_completed adds history.

• Get Vault

  Collateral vault for an account: vault name, CBTC collateral balance, and the BTC address to fund it.

• Get Redemption Queue

  Queued lender redemptions (TPF → USDT waiting for liquidity), optionally one account.

• Get Btc Price

  Authoritative BTC/USD price from the on-chain oracle contract — the average of a round of independent feeders (at least 3, agreeing within 10%, or the round is skipped and the previous price stands), and the price the loan contract uses for LTV and liquidation. Prefer this over any external exchange price. A feed older than 5 minutes is marked stale and must not be used for collateral math.

• Setup Deposit Address

  Compose registration with a bridge so the account is assigned its own Bitcoin address, which is how an agent funds itself. Sign this, then poll get_deposit_address: the bridge signers assign the address a short time later (about a minute on testnet), so it is NOT available immediately. bridge "btc" (x.libre, default) is the wallet balance used for trading; "vault" (v.libre) is loan collateral, and setup_vault already handles that path for borrowing. Fails if an address already exists.

• Transfer

  Compose a token transfer on Libre (unsigned). Returns actions + esr.

• Place Order

  Compose a dex.libre limit order. amount is in the base token (BTC for btcusdt), price in quote per base (USDT; BTC with 10 decimals for librebtc). Buys lock amount*price of quote; sells lock amount of base.

• Cancel Order

  Compose cancellation of an open dex.libre order (see get_orders for ids).

• Withdraw Btc

  Compose a BTC withdrawal (bridge peg-out) from Libre to a Bitcoin address. Bridge fee applies (x.libre feeconfig table).

• Setup Vault

  Compose collateral-vault creation (createvault + genaddr). The vault sub-account name is generated here and returned as vault_name. Afterwards get_vault returns the BTC address to fund.

• Borrow

  Compose a variable-rate USDT loan against vault collateral. Minimum loan is 0.001 BTC worth of USDT (~$80 at current prices; the floor is BTC-denominated so the USDT figure moves). max_apr_bps is a slippage cap on the interest rate, compared against the APR AFTER this loan is disbursed — your own borrowing raises utilization, so the post-disbursement rate is higher than the one get_pool_stats shows now. A request over the cap is not rejected: it stays in the loan queue and opens if the rate late

• Cancel Loan Request

  Compose cancellation of a queued (unfilled) loan request.

• Repay

  Compose a USDT repayment toward the account's loan.

• Withdraw Collateral

  Compose a collateral withdrawal (CBTC → BTC to an address). Fails on-chain if it would breach LTV. The v.libre bridge charges 50 bps on the way out, capped at 0.005 CBTC, with a 0.0008 CBTC minimum withdrawal; funding a vault is free.

• Lend

  Compose a USDT deposit into the lending pool (mints TPF shares).

• Redeem

  Compose redemption of TPF shares for USDT (queued if liquidity is out on loan).

• Cancel Redeem

  Compose cancellation of a queued redemption by id (see get_redemption_queue).