Alpha Arcade surfaces

Amarok is an Alpha Arcade research + unsigned execution API. Surfaces below share discovery metadata and x402 policy at https://amarok-api.compx.io.

Rewards

Paid LP reward ranking — safest emissions-farming lane.

Spreads

Paid maker/spread opportunity ranking.

Parity

Paid YES+NO parity opportunity ranking.

Opportunities

Mixed ranked view across LP reward, spread, and parity.

Markets

Paid market search/filter plus single-market deep dive.

Quotes

Paid actionable bid/ask suggestions from the quote engine.

Scan

Paid scan: normalized markets plus orderbook tops (TTL-cached). Capped ~12 markets / 45s so MCP clients (~60s) finish; may return timedOut/capped.

Research bundle

Paid one-shot SKU: opportunities + quotes + N market details. Additive to per-request 402.

Research session

Paid 1h capability for research GETs via AMAROK-SESSION. Scan/execution/portfolio/advisor/watchlist stay per-request.

Watchlist

Paid register of market ids plus delta poll from coarse 5m history (top 25 per lane). Not a full rescan.

Portfolio

Paid portfolio-by-address: balances, positions with mark-to-market, open orders, bid escrow. Ghillie stays the free showcase.

Advisor

Paid inventory-aware advisor: post snapshot, get exits / cancels / claims / size adjustments. Snapshot is authoritative.

Execution

Free shapes + paid unsigned place/cancel/claim/market/merge/split/opt-in transaction groups.

Research loop

  1. Paid GET /v1/alpha/opportunities (0.005 USDC) — ranked lanes.
  2. Paid GET /v1/alpha/markets/{marketAppId} (0.005 USDC) — deep dive.
  3. Paid GET /v1/alpha/quotes (0.006 USDC) — suggested bids/asks.
  4. Paid GET /v1/alpha/bundle (0.02 USDC) — one payment for opportunities + quotes + N market details (additive; default still per-request 402).
  5. Paid POST /v1/alpha/session (0.03 USDC) — 1h AMAROK-SESSION for research GETs (not scan / execution / portfolio / advisor / watchlist).
  6. Paid POST /v1/alpha/watchlist then GET /v1/alpha/watchlist (0.008 USDC) — register market ids and poll ranked deltas from coarse 5m history (not a full rescan).
  7. Paid GET /v1/alpha/scan (0.025 USDC) — capped scan (TTL-cached; MCP-safe ~12 markets / 45s).
  8. Paid GET /v1/alpha/portfolio/{address} (0.005 USDC) — own-wallet balances, positions (MTM), open orders, bid escrow. Free exception: /public/agents/ghillie/portfolio.
  9. Paid POST /v1/alpha/advisor (0.008 USDC) — post authoritative snapshot; suggested exits, cancels, claims, size adjustments. Empty-wallet quotes stay on /v1/alpha/quotes.

Execution loop

  1. Free GET /v1/alpha/execution/shapes — unsigned txn builders.
  2. Paid POST /v1/alpha/execution/quotes (0.01 USDC) — returns unsignedTxnsBase64 for limit, cancel, claim, market (match legs), merge, split, and opt-in. /parity is research-only.
  3. Agent signs and submits via own algod. meta.executionSubmitted is always false.

See endpoints, examples, and x402 for payment and payload details. Polymarket and Kalshi /v1/polymarket/* / /v1/kalshi/* are separate scan-only families — no Alpha execution, quotes, bundle, or watchlist on those routes. See venues.