trade.loomdesk/loomdesk

The protocol-owned liquidity book: value, positions, fees collected, earnings waiting for the daily 18:00 UTC payout, and what has been paid to LOOM holders.

Everything list_pools knows about one pool plus its v4 pool key, by symbol (LoomDesk's own pool of that stock if there is one, else the deepest) or by pool id.

For one token: the pools a ladder can go in, in the order the site offers them (real markets that pay their liquidity first; then real markets whose launchpad hook keeps the whole fee, where a ladder is only a grid of orders; then small ones). Each with swap fee, whether it pays liquidity, depth, 24h volume and fees, and fees as a share of liquidity per week. The first is the default.

Tokenized stock pools on Robinhood Chain with what a dollar of liquidity earned in them (weekly rate at ±5/10/15/25% ranges), how much of those fees the pool kept after arbitrage (keep), depth, and 24h flow. LoomDesk's own pools are marked own: true; those are the pools Earn opens positions in, and the ones a tenth of whose swap fees pay the LoomDesk book. Rates are measurements of the past week, not forecasts.

Every token that traded in the last day, from LoomDesk's own index of every swap on the chain: price, market cap, 24h volume, fees, trades, depth, age, tier (established / new / untested) and keep (the share of its fees the busiest pool kept after the price moved). Flagged tokens (a stranger cannot sell them, or they tax transfers) are left out. `query` searches by symbol, name or address. `leadersWindowSeconds` instead returns the most traded and highest volume tokens over that window (300 to 604800).

Every live ladder of a wallet (on the current LoomLadder and earlier ones): pair, rungs with what each holds and which side of the price it is on, value, fees waiting (after LoomDesk's share), fees already collected, PnL against simply holding what went in, and the wallet's history of opens, collects, partial withdraws and closes.

The Uniswap v4 positions a wallet opened through LoomDesk Earn: pool, range, whether in range, value and uncollected fees.

One transaction (two when paying in USDG: its approval first) from ETH or USDG to a ladder in a v4 pool of the token against the quote (ETH, USDG, LOOM, a stock, a memecoin with an exit). The pool is opened on LoomDesk's hook inside the same transaction when the pair has none (feePct 1 to 5, about a dollar); the sides the wallet's asset is not are bought through Nordstern inside it, split by the band; the pool's fee is paid from it; the ladder is built for the owner; leftovers come back. Prefer it over plan_swap + plan_open_pool + plan_ladder whenever the caller pays in ETH or USDG.

For a wallet that already holds the assets it brings; from ETH or USDG, plan_build does the whole thing in one transaction. A ladder is one deposit spread over up to 40 narrow one-sided ranges ('rungs') of a Uniswap v3 or v4 pool: rungs under the price hold the quote asset (ETH, WETH, USDG or LOOM) and buy the token as it falls, rungs over the price hold the token and sell it as it rises, and rungs the price trades through earn the pool's swap fee. Give the band as percent from the current price (lowPct negative for under the price), the amounts as decimal strings, and the owner wallet. With one asset only, `split: true` swaps part of it for the other in the same pool and builds the whole band in one transaction (the minimum out comes from the chain's quoter, hook taxes included). Returns the unsigned transactions (approvals if needed, then the open or the zap) laid out from the pool's price on the chain right now. You sign and send them from the owner wallet; nothing is signed or sent here. Fees: 0.25% of what goes in, taken out of the rungs as they are minted (0.1% of it to `referrer` when given, 0.1% to the owner of the ladder `copyOf` names while it is open in the same pair); then 5% of the trading fees the ladder earns and 5% of any gain on the liquidity when it is taken out (nothing from a loss), or 5% of the ladder's value when the NFTs are taken out instead; 3.5% for an owner holding 100,000 LOOM. Every cut is paid as USDG, with a slice of the token sold in the same pool when the money side is short.

The unsigned transaction for one of a ladder's exits. collect: pays the fees earned and leaves the ladder working. close_part: takes sharePct of every rung out, the rest keeps working. close: pays the fees and returns everything. take_nfts: hands the Uniswap position NFTs to the owner; it always works, even when new ladders are paused. close and close_part are simulated first and carry minimums from slippagePct.

When a token has no pool against the quote wanted (ladder_pools shows none, or none that pays liquidity): plan a new Uniswap v4 pool for it on LoomDesk's open hook, with a flat 1% or 3% swap fee: nine tenths to liquidity providers, one tenth to the LoomDesk book. The quote can be ETH, USDG, a tokenized stock, LOOM, or any token with a real exit (2,000 USDG of liquidity on the chain and a route to USDG): LOOM/PONS, a memecoin against a memecoin. One-off cost about a dollar (1 USDG or 0.0004 ETH), paid by the owner. It opens at the price of the token's existing market. Expect its flow to be mostly arbitrage plus what routers send; a new pool starts with neither. The pool holds nothing until a ladder is built in it: the result's `then` carries the pool id and key for plan_ladder (with newPool), so the pool and the ladder can be planned together and signed in order.

The unsigned transactions for a swap on the chain through Nordstern's aggregator (an approval of the router when paying with a token, then the route), with what it returns and the least it may. For a pair the caller wants but only holds ETH or USDG for: one plan_swap per missing side, then plan_ladder with to.atLeast as that side's amount. Nothing is signed here.

For an amount of USDG and a range around the current price in one of LoomDesk's own pools: the 1% fee to open, the stock the desk would buy, the ticks, what the position would have earned per week at the pool's measured rate, and the two transactions (USDG approve, EarnDeskV4.open) that open it, minted to the sender's wallet. Nothing is sent: the caller signs and sends them from its own wallet within 20 minutes. Keep a deposit under maxSensibleDepositUsdg: in a shallow pool a larger buy of the stock side moves the price against you.