For the complete documentation index, see llms.txt. This page is also available as Markdown.

Fund Markets (Liquidity Providers)

Liquidity Providers supply capital to a market’s pool and earn yield as borrowers repay. Programmatically, funding is the pool-adapter flow: deposit for shares, and a two-step delayed withdrawal.


Discover pools

# pools your arena exposes
curl -H "X-Arena-Key: $ARENA_KEY" "$ARENAS_API/lending/pools"
# an account's positions, shares, and pending withdrawals
curl -H "X-Arena-Key: $ARENA_KEY" "$ARENAS_API/lending/pools/list/$ACCOUNT"

Use a pool where the item exposes an adapterInfo.address — that adapter is the contract you interact with (not the pool share-token address).


Deposit

  1. approve the asset token to the adapter address.

  2. deposit into the adapter to receive pool shares.

Before submitting, check the adapter’s cap vs totalDeposited (cap = 0 means unlimited) and confirm the pool phase currently allows deposits.


Withdraw (two-step, delayed)

Withdrawal is always two on-chain steps, even when the delay is zero:

  1. createWithdrawRequest — locks your shares (approve the pool share token to the adapter first). One active request per LP; not cancellable.

  2. executeWithdrawRequest — after withdrawDelay elapses, the same wallet executes and receives assets.

See Supply and Withdraw for the mechanics.


How your capital is used

Deposited liquidity is offered to borrowers as intents — priced offers filled cheapest-first when a borrower draws down. Your yield tracks the interest borrowers pay on the intents your pool fills. See Intents & Liquidity.


Boosted yield via Aave

LPs can amplify returns by supplying Aave collateral, delegating its borrowing power, and routing the borrowed liquidity into Atomica pools to earn the spread. See the Aave Market strategy and Credit Delegation.


After every write

Poll GET /provisioning-sync/last-synced-blocks until your transaction’s block is indexed, then refetch pools/list/:account so balances and pending-withdrawal state are current.

Last updated