For builders
Ship agent integrations faster with OpenAPI schemas, discovery metadata, and a consistent response envelope — instead of maintaining private Alpha adapters.
x402 paid Alpha research + execution quotes
Hunt Alpha. Quote. Never custody.
Amarok is a walletless research API for Algorand Alpha markets — plus unsigned limit-order
groups your agent signs and submits itself. Discoverable contracts, x402 USDC at the edge,
and executionSubmitted: false always.
- x402 payments
- Remote MCP
- OpenAPI / discovery
- Unsigned execution quotes
- Algorand USDC
What it is
One API for Alpha research and unsigned execution
Amarok exposes ranked opportunities, market deep-dives, quote suggestions, and full scans through agent-discoverable, x402-paid routes at the Caddy gateway — then hands back unsigned txn groups for resting limit orders. 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.
Execution Quotes
Unsigned Alpha limit-order groups
/v1/alpha/execution/quotes Market
Alpha market deep dive
/v1/alpha/markets/{marketAppId} marketAppId
Opportunities
Ranked Alpha opportunities
/v1/alpha/opportunities Quotes
Suggested Alpha quotes
/v1/alpha/quotes Scan
Full Alpha scan summary
/v1/alpha/scan Discovery
Route access catalog
/discovery No endpoints match this filter.
The problem
What agents do today without Amarok
Alpha 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 Alpha market scanners and orderbook normalizers for 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 Alpha opportunities, markets, quotes, and full scans.
- Stable schemas plus free execution-shape catalog and paid unsigned limit-order 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 Alpha
Pull ranked opportunities, market deep-dives, suggested quotes, and full scan summaries — pay per request in USDC.
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 Alpha opportunities, then an unsigned limit-order group to rest liquidity. 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
Alpha surfaces, one schema
Research and execution routes share discovery metadata and x402 policy so agents can learn the contract once and reuse it across opportunities, scan, and unsigned quotes.
Opportunities
Paid ranked LP reward, maker/spread, and parity opportunities.
Markets
Paid single-market deep dive with book tops and related slice.
Quotes
Paid actionable bid/ask suggestions from the quote engine.
Scan
Paid full scan: normalized markets plus orderbook tops (TTL-cached).
Execution
Free shapes + paid unsigned limit-order transaction groups.
Give your agent a paid Alpha research rail
Connect to Amarok, discover the contracts, research markets, and fetch unsigned execution quotes — walletless, x402-gated, ready for autonomous execution.