For builders
Ship agent integrations faster with OpenAPI schemas, discovery metadata, and a consistent response envelope — instead of maintaining a private adapter for every venue.
x402-paid prediction market intelligence
Prediction market intelligence for agents
Amarok ranks opportunities across Alpha Arcade, Polymarket, and Kalshi, then returns unsigned Alpha Arcade execution groups your agent signs and submits itself. Discoverable contracts, USDC via x402 at the edge.
- x402 payments
- Remote MCP
- OpenAPI / discovery
- Unsigned execution quotes
- Scan-only Polymarket / Kalshi
- Algorand USDC
What it is
One intelligence layer for prediction markets
Amarok exposes ranked opportunities, market deep-dives, quote suggestions, and scans across Alpha Arcade, Polymarket, and Kalshi through agent-discoverable, x402-paid routes at the Caddy gateway. On Alpha Arcade it also returns unsigned txn groups for placing, canceling, and claiming positions. Builders get stable contracts. Agents keep the keys.
For agents
Research markets, rank opportunities, fetch unsigned execution quotes, then pay per request and keep executing — without giving Amarok custody.
Live surface
View all endpoints → Core APIs agents can call
Paid research routes and free discovery/shapes endpoints — method, pricing, and parameters from the same discovery metadata your agent will read.
Alpha Advisor
Inventory-aware Alpha Arcade advisor
/v1/alpha/advisor Research Bundle
Research bundle (opportunities + quotes + N markets)
/v1/alpha/bundle qcategoryhorizonserieshasRewardslimitoffsetmarketLimitmarketAppIds
Execution Quotes
Unsigned Alpha Arcade execution groups
/v1/alpha/execution/quotes Markets List
Search and filter Alpha Arcade markets
/v1/alpha/markets qcategoryhorizonserieshasRewardslimitoffset
Market
Alpha Arcade market deep dive
/v1/alpha/markets/{marketAppId} marketAppId
Opportunities
Mixed ranked Alpha Arcade opportunities
/v1/alpha/opportunities qcategoryhorizonserieshasRewardslimitoffset
No endpoints match this filter.
The problem
What agents do today without Amarok
Prediction-market research and unsigned execution are hard to productize. Every agent rebuilds the same scanners, ranks, and txn builders — and payment access stays ad hoc.
Without Amarok
- Rebuild market scanners and orderbook normalizers for every venue and every agent integration.
- Hand-roll ranking across reward, maker, and parity lanes with inconsistent confidence rules.
- Invent your own unsigned txn builders and hope schemas stay stable.
- Juggle fragmented payment gates with no machine-readable discovery contract.
With Amarok
- One research API for ranked opportunities, markets, quotes, and scans across prediction markets.
- Alpha Arcade research plus unsigned execution; scan-only Polymarket and Kalshi on /v1/polymarket/* and /v1/kalshi/*.
- Stable schemas plus a free execution-shape catalog and paid unsigned place/cancel/claim groups.
- Discover routes and pricing through /discovery and /openapi.json.
- Connect via remote MCP tools or direct HTTP with x402 at the Caddy gateway.
Capabilities
What agents can do with it
Discover contracts
Fetch /discovery and /openapi.json to learn every free and paid route, pricing, and schema before writing a single integration.
Research prediction markets
Pull ranked opportunities, market deep-dives, suggested quotes, and scan summaries across Alpha Arcade, Polymarket, and Kalshi — pay per request in USDC.
Scan Polymarket and Kalshi
Call scan-only /v1/polymarket/* and /v1/kalshi/* for capped books and lane rankings. No execution, WebSockets, Perps, or cross-venue matching on those families.
List execution shapes
Call free GET /v1/alpha/execution/shapes to learn which unsigned txn builders Amarok supports before quoting.
Use MCP tools
Connect to the remote Streamable HTTP MCP endpoint for typed amarok_* tools — walletless paid-tool preflight and client-side paymentSignature retry.
Get unsigned quotes
POST /v1/alpha/execution/quotes returns unsignedTxnsBase64. Amarok never signs or submits — meta.executionSubmitted is always false.
Case study
Research to unsigned quote in one loop
An agent needs ranked opportunities, then an unsigned Alpha Arcade execution group to place, cancel, claim, match, merge, or split. Amarok returns research and unsigned txns — the agent signs and submits on its own algod.
1. Research
Agent pays via x402 and calls
/v1/alpha/opportunities for ranked lanes.
2. Shapes
Agent reads free
/v1/alpha/execution/shapes to pick a builder.
3. Quote
Agent pays and
POSTs /v1/alpha/execution/quotes.
4. Agent submits
Signs
unsignedTxnsBase64 and submits — Amarok never submits.
Agent request (sample)
GET https://amarok-api.compx.io/v1/alpha/opportunities Agent reads (illustrative) Top opportunity $12.40/day LP reward lane (sample) Market SAMPLE-MARKET Illustrative app id Confidence 0.82 Normalized score Execution unsigned executionSubmitted: false
See sample payloads on the examples page.
How it works
From discovery to action in four steps
Discover
Agent fetches /discovery and /openapi.json to learn available routes, schemas, and x402 pricing.
Preflight
Agent calls a paid route without PAYMENT-SIGNATURE. Gateway returns 402 with payment requirements.
Pay
Agent wallet signs the USDC transfer payload and retries with PAYMENT-SIGNATURE.
Act
Gateway verifies and settles. Agent receives research data or unsigned txn groups, then signs and submits on its own algod.
Coverage
Prediction-market surfaces, one schema
Alpha Arcade research and unsigned execution, plus scan-only Polymarket and Kalshi, share discovery metadata and x402 policy so agents can learn the contract once.
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.
Polymarket scan
Paid scan-only: capped Gamma markets + CLOB book tops. Own POLY_SCAN_* in-process TTL — not Alpha scanCache.
Polymarket lanes
Paid rewards / spreads / parity / mixed opportunities plus markets list/detail. Light GETs are session-covered.
Kalshi scan
Paid scan-only: capped markets + inferred two-sided book tops. Own KALSHI_SCAN_* in-process TTL — not Alpha scanCache.
Kalshi lanes
Paid rewards / spreads / parity / mixed opportunities plus markets by ticker. Light GETs are session-covered.
Not in 1.7.0
No execution, WebSockets, Perps, cross-venue matching, quotes/bundle SKUs, watchlist/history, or GET /quotes on these families.
Full surface notes in alpha, venues (scan-only Polymarket / Kalshi), and endpoints.
Give your agent a paid prediction-market intelligence layer
Connect to Amarok, discover the contracts, research markets across venues, and fetch unsigned Alpha Arcade execution quotes — walletless, x402-gated, ready for autonomous agents.