# AMAROK

> x402-gated Algorand Alpha research API + unsigned execution quotes for autonomous agents. Pay in USDC micropayments at the gateway edge, fetch ranked opportunities / markets / scans, and receive unsigned txn groups. Amarok never holds keys and never submits orders (`meta.executionSubmitted` is always false).

Use the **Caddy gateway** (`https://amarok-api.compx.io`) for all API calls. Discovery, OpenAPI, and execution shapes are free; research and execution-quote routes require x402 payment as advertised. For the full integration guide in one file, see [llms-full.txt](https://amarok.compx.io/llms-full.txt).

## API (machine-readable)

- [Discovery](https://amarok-api.compx.io/discovery): route catalog, x402 prices, MCP tool list
- [OpenAPI](https://amarok-api.compx.io/openapi.json): schemas and operation metadata
- [MCP server](https://amarok.compx.io/mcp): remote Streamable HTTP MCP at `https://amarok-mcp.compx.io/mcp` (walletless pass-through)

## Integration guides

- [Quickstart](https://amarok.compx.io/quickstart): agent onboarding (MCP or direct HTTP)
- [MCP setup](https://amarok.compx.io/mcp): connect to `https://amarok-mcp.compx.io/mcp`, paid-tool paymentSignature retry
- [x402 payment flow](https://amarok.compx.io/x402): preflight 402, sign USDC transfer, retry with PAYMENT-SIGNATURE
- [Examples](https://amarok.compx.io/examples): copy-paste curl and sample payloads
- [Endpoint catalog](https://amarok.compx.io/endpoints): human-readable route cards sourced from discovery
- [Alpha surfaces](https://amarok.compx.io/alpha): research + unsigned execution loop
- [Live transactions](https://amarok.compx.io/transactions): recent inbound USDC payments to the x402 pay-to wallet

## Paid routes

- [GET /v1/alpha/opportunities](https://amarok-api.compx.io/v1/alpha/opportunities): 0.05 USDC — Ranked Alpha opportunities
- [GET /v1/alpha/markets/{marketAppId}](https://amarok-api.compx.io/v1/alpha/markets/{marketAppId}): 0.05 USDC — Alpha market deep dive
- [GET /v1/alpha/quotes](https://amarok-api.compx.io/v1/alpha/quotes): 0.06 USDC — Suggested Alpha quotes
- [GET /v1/alpha/scan](https://amarok-api.compx.io/v1/alpha/scan): 0.25 USDC — Full Alpha scan summary
- [POST /v1/alpha/execution/quotes](https://amarok-api.compx.io/v1/alpha/execution/quotes): 0.10 USDC — Unsigned Alpha limit-order groups

## Optional

- [Full LLM guide](https://amarok.compx.io/llms-full.txt): self-contained integration reference
- [FAQ](https://amarok.compx.io/faq): gateway vs upstream, 402 behavior, custody rules
- [Terms and disclaimer](https://amarok.compx.io/terms): informational-only use, no financial advice
- [Support](mailto:kieran@neonforge.ltd): kieran@neonforge.ltd (Neon Forge Ltd)