Choice Exchange

Choice Best Route

Find the best swap route on Injective via Choice route-finding + aggregation. Pulls candidate routes from the Choice router (across AMM, CLMM and Helix orderbooks), re-quotes each one on-chain against the current block, and returns the best. Read-only — returns expected output, price and a candidate comparison, but no transaction to sign. Args: token_in: input token — symbol (INJ/USDT/USDC/...) or on-chain id. token_out: output token — symbol or on-chain id. amount: human amoun

Choice Quote

Best-route quote PLUS a ready-to-broadcast Injective transaction (non-custodial). Same routing as ``choice_best_route``, but also returns the exact ``MsgExecuteContract`` payload (contract, msg, funds) and ``minimum_receive`` so the *caller* can sign and broadcast it from their own wallet. The Choice aggregator is permissionless and enforces ``minimum_receive`` on-chain, reverting if not met. Args are identical to ``choice_best_route``.

Choice Token

Bundled overview of a token: price, 1h/24h/7d changes, market cap / FDV, supply, liquidity, holder count, and its top markets by 24h volume. Args: query: token symbol (SHROOM/INJ/USDT/...), name, or on-chain id.

Choice Token Holders

Top holders of a token + concentration (top10 / top50 %), from the last indexed balance snapshot (``indexed_at`` says how fresh). Args: query: token symbol, name, or on-chain id. limit: number of holders to list (1-100, default 10).

Choice Market

Complete pair stats: price plus TOTAL liquidity and 24h volume across every market source for the pair (Choice XYK, external AMMs, CLMM, Helix orderbook — either orientation), with a per-source breakdown. Each source carries two consistently-oriented prices for the resolved pair: ``price_usd`` (the base token in USD) and ``price_in_quote`` (the base token priced in the quote token) — directly comparable across venues regardless of how a given pool stores its own base/quote orientation. Args:

Choice Market Candles

Compact OHLCV candles as ``[t, o, h, l, c, v]`` arrays (USD-priced when available). Args: query: pair / token / pool address / Helix market id. interval: one of 1m,3m,5m,15m,30m,1h,4h,12h,1d,1w,1M (default 1h). limit: number of candles, newest-anchored (1-500, default 24).

Choice Market Trades

Recent trades as compact ``[t, side, price, size_usd]`` arrays (newest first). Args: query: pair / token / pool address / Helix market id. limit: number of trades (1-100, default 20).

Choice Perp

Perp market overview: mark price, current funding rate (bps + naive-annualized %), next funding time, oracle (provider + feed), margin ratios, and 24h volume. Args: query: perp market ("INJ", "INJ perp", or a Helix derivative market id).

Choice Trending

Ranked trending tokens by heat. Args: horizon: window — "1h", "6h", or "24h" (default 24h). limit: number of tokens (1-50, default 10).

Choice Top Markets

Leaderboard of markets by 24h volume across venues. Args: kind: filter to a venue — "amm", "clmm", "orderbook", or "all" (default all). limit: number of markets (1-50, default 10).

Choice Dex Overview

Choice DEX ecosystem snapshot: TVL, trailing-24h volume (AMM/CLMM/orderbook split), 24h fees, active wallets, and lifetime cumulative volume.

Choice New Listings

Pools created recently (all routed DEX XYK + Choice CLMM), newest first, with current liquidity, 24h volume, and Shroompad launchpad-graduation flags — the sourcing feed for new tokens. Args: days: lookback window in days (1-30, default 7). limit: number of listings (1-50, default 20). min_liquidity_usd: drop pools below this current liquidity (default 0).

Choice Token Safety

Coded rug/exit-liquidity screen for a token: liquidity, holder concentration (pool/burn/treasury holders labelled + excluded from the actionable number), market breadth, oldest-pool age, launchpad provenance, and a round-trip route probe (INJ -> token -> INJ) reporting the % lost to a full exit. ``flags`` lists every positively-established finding (low_liquidity, concentrated_top10, young_token, single_market, expensive_round_trip, no_route, not_curated, stale_holder_data). Args: query: tok

Choice Wallet

A wallet's recent trading: swaps (Choice aggregation + CLMM, tx-deduped), direct Helix orderbook fills, per-token flow accounting (bought/sold USD, net amount marked at the current price), and its current LP positions under ``liquidity`` (XYK + CLMM, each CLMM position flagged ``in_range``) — a stock at the latest snapshot, not window flow, so a large liquidity provider no longer reads as a small trader. PnL is window-flow based — exact for a fresh wallet, labelled flow accounting otherwise. Sta

Choice Lp Holders

Largest liquidity providers on Choice at the latest LP snapshot, aggregated per wallet across pools. This is the "who supplies the liquidity" tool — the trading tools cannot answer it, because providing liquidity produces no swap rows. CLMM value is **in-range only**: a position counts solely while the pool's current tick sits inside its range. So ``kind="clmm", min_usd=100`` means "wallets with over $100 of in-range concentrated liquidity", with no further filtering needed. ``basis="live"`` (

Choice Resolve

Turn a user string into a concrete token and/or market identity (or surface that it is ambiguous) before any other call. When a symbol has copies (scam/duplicate tokens), the chosen match is the curated one and ``ambiguous`` is true; ``alternatives`` then lists the other candidates (address, verified flag, price, liquidity) so the caller can disambiguate instead of guessing. Args: q: the string to resolve (symbol, name, pair, pool address, market id). type: what to look for — "token",