{"openapi":"3.0.3","info":{"title":"Amarok API","version":"1.0.0","description":"Walletless Alpha Arcade market intelligence and unsigned execution quotes. Free routes are ungated; paid routes use x402 (Algorand USDC). Amarok never signs or submits transactions."},"servers":[{"url":"https://amarok-api.compx.io"}],"paths":{"/health":{"get":{"operationId":"getHealth","summary":"Liveness check","description":"Ungated health probe for the Amarok API.","tags":["amarok"],"responses":{"200":{"description":"Success"}}}},"/discovery":{"get":{"operationId":"getDiscovery","summary":"Route access catalog","description":"Lists free vs paid Amarok routes and x402 payment requirement templates. Call this before paid endpoints.","tags":["amarok"],"responses":{"200":{"description":"Success"}}}},"/openapi.json":{"get":{"operationId":"getOpenApi","summary":"OpenAPI document","description":"OpenAPI 3 document with x402 extensions on paid operations.","tags":["amarok"],"responses":{"200":{"description":"Success"}}}},"/v1/alpha/opportunities":{"get":{"operationId":"getAlphaOpportunities","summary":"Ranked Alpha Arcade opportunities","description":"Paid ranked LP reward, maker/spread, and parity opportunities with confidence and estimated $/day. Preflight may return 402 with PAYMENT-REQUIRED; retry with PAYMENT-SIGNATURE.","tags":["amarok"],"responses":{"200":{"description":"Success (payment accepted)"},"402":{"description":"Payment required — send PAYMENT-SIGNATURE and retry"}},"x-x402":{"scheme":"exact","network":"algorand-mainnet","asset":"31566704","payTo":"R3CUFK5EMFJSHV5TEXMBJOCASYHORZ2F7QCPPVCRWRWVDL5WNLSDOIEHBU","maxAmountRequired":"50000","maxAmountRequiredUnit":"micro-USDC","priceUsdc":"0.05"}}},"/v1/alpha/markets/{marketAppId}":{"get":{"operationId":"getAlphaMarket","summary":"Alpha Arcade market deep dive","description":"Paid single-market detail with normalized book tops and related opportunity slice. Preflight may return 402; retry with PAYMENT-SIGNATURE.","tags":["amarok"],"responses":{"200":{"description":"Success (payment accepted)"},"402":{"description":"Payment required — send PAYMENT-SIGNATURE and retry"}},"x-x402":{"scheme":"exact","network":"algorand-mainnet","asset":"31566704","payTo":"R3CUFK5EMFJSHV5TEXMBJOCASYHORZ2F7QCPPVCRWRWVDL5WNLSDOIEHBU","maxAmountRequired":"50000","maxAmountRequiredUnit":"micro-USDC","priceUsdc":"0.05"}}},"/v1/alpha/quotes":{"get":{"operationId":"getAlphaQuotes","summary":"Suggested Alpha Arcade quotes","description":"Paid actionable bid/ask suggestions from the quote engine (reward and spread lanes only; no wallet inventory exits). Preflight may return 402; retry with PAYMENT-SIGNATURE.","tags":["amarok"],"responses":{"200":{"description":"Success (payment accepted)"},"402":{"description":"Payment required — send PAYMENT-SIGNATURE and retry"}},"x-x402":{"scheme":"exact","network":"algorand-mainnet","asset":"31566704","payTo":"R3CUFK5EMFJSHV5TEXMBJOCASYHORZ2F7QCPPVCRWRWVDL5WNLSDOIEHBU","maxAmountRequired":"60000","maxAmountRequiredUnit":"micro-USDC","priceUsdc":"0.06"}}},"/v1/alpha/scan":{"get":{"operationId":"getAlphaScan","summary":"Full Alpha Arcade scan summary","description":"Paid normalized markets plus orderbook tops (mids/spreads/depth summary). Heaviest compute; responses are TTL-cached. Preflight may return 402; retry with PAYMENT-SIGNATURE.","tags":["amarok"],"responses":{"200":{"description":"Success (payment accepted)"},"402":{"description":"Payment required — send PAYMENT-SIGNATURE and retry"}},"x-x402":{"scheme":"exact","network":"algorand-mainnet","asset":"31566704","payTo":"R3CUFK5EMFJSHV5TEXMBJOCASYHORZ2F7QCPPVCRWRWVDL5WNLSDOIEHBU","maxAmountRequired":"250000","maxAmountRequiredUnit":"micro-USDC","priceUsdc":"0.25"}}},"/v1/alpha/execution/shapes":{"get":{"operationId":"listExecutionShapes","summary":"Execution shape catalog","description":"Free catalog of Amarok execution shapes (unsigned txn builders). Agents use these with POST /v1/alpha/execution/quotes.","tags":["amarok"],"responses":{"200":{"description":"Success"}}}},"/v1/alpha/execution/quotes":{"post":{"operationId":"createExecutionQuotes","summary":"Unsigned Alpha Arcade limit-order groups","description":"Paid: build unsigned Algorand transaction groups for resting limit orders (alpha_place_limit_order). Amarok never signs or submits; agent signs unsignedTxnsBase64 and submits via own algod. Preflight may return 402; retry with PAYMENT-SIGNATURE.","tags":["amarok"],"responses":{"200":{"description":"Success (payment accepted)"},"402":{"description":"Payment required — send PAYMENT-SIGNATURE and retry"}},"x-x402":{"scheme":"exact","network":"algorand-mainnet","asset":"31566704","payTo":"R3CUFK5EMFJSHV5TEXMBJOCASYHORZ2F7QCPPVCRWRWVDL5WNLSDOIEHBU","maxAmountRequired":"100000","maxAmountRequiredUnit":"micro-USDC","priceUsdc":"0.10"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["agentAddress","quotes"],"properties":{"agentAddress":{"type":"string"},"quotes":{"type":"array","items":{"type":"object","required":["shapeKey","input"],"properties":{"shapeKey":{"type":"string","enum":["alpha_place_limit_order"]},"input":{"type":"object"}}}}}}}}}}}},"x-mcpServer":{"transport":"streamable-http","url":"https://amarok.compx.io/mcp","package":"@amarok/mcp","tools":["amarok_health","amarok_get_discovery","amarok_get_openapi","amarok_list_opportunities","amarok_get_market","amarok_get_quotes","amarok_get_scan","amarok_list_execution_shapes","amarok_get_execution_quote"]},"x-x402":{"protocolVersion":2,"facilitatorUrl":"https://facilitator.goplausible.xyz","network":"algorand-mainnet","scheme":"exact","assetId":"31566704","payTo":"R3CUFK5EMFJSHV5TEXMBJOCASYHORZ2F7QCPPVCRWRWVDL5WNLSDOIEHBU","mode":"edge","headers":["PAYMENT-REQUIRED","PAYMENT-SIGNATURE","PAYMENT-RESPONSE"]}}