# CANIX402 > x402-gated DeFi data and walletless transaction API for autonomous agents. Pay in Algorand or Base USDC at the gateway edge, fetch normalized APY/TVL data, and build locally signable groups. An Algorand-only agent does not supply a Base address. # pragma: allowlist secret Use the **Caddy gateway** (`https://canix402-api.compx.io`) for all API calls. Discovery, execution shapes, swap quotes, and opt-in preparation are free; data routes, execution quotes, and swap transaction generation require x402 payment as advertised. Agents may pay and act on Algorand, on Base, or on both. Omitting a Base address does not change rank, eligibility, price, or access. The API never receives wallet keys or submits transactions. For the full integration guide in one file, see [llms-full.txt](https://canix402.compx.io/llms-full.txt). # pragma: allowlist secret ## API (machine-readable) - [Discovery](https://canix402-api.compx.io/discovery): endpoint catalog, x402 prices, error codes, facilitator metadata - [OpenAPI](https://canix402-api.compx.io/openapi.json): schemas, query parameters, response examples - [x402 manifest](https://canix402-api.compx.io/.well-known/x402.json): directory indexing surface for agent tooling and x402 directories - [MCP server](https://canix402.compx.io/mcp): remote Streamable HTTP MCP at `https://canix402-mcp.compx.io/mcp` (walletless pass-through) - [Live](https://canix402.compx.io/webmcp): same MCP tools registered in-page via the WebMCP imperative API ## Integration guides - [Get started](https://canix402.compx.io/quickstart): human setup prompt (#human) and agent onboarding (#agent) - [MCP setup](https://canix402.compx.io/mcp): connect to `https://canix402-mcp.compx.io/mcp`, paid-tool paymentSignature retry - [Live](https://canix402.compx.io/webmcp): `document.modelContext.registerTool` (Chrome) / `navigator.modelContext` fallback; fail-closed execute - [x402 payment flow](https://canix402.compx.io/x402): preflight 402, pay on Algorand or Base USDC, retry with PAYMENT-SIGNATURE - [Examples](https://canix402.compx.io/examples): copy-paste curl and sample payloads - [Endpoint catalog](https://canix402.compx.io/endpoints): human-readable route table sourced from discovery - [Live transactions](https://canix402.compx.io/transactions): recent inbound USDC payments to the x402 pay-to wallet - [Release notes](https://canix402.compx.io/release-notes): latest protocol package changelog ## Paid data routes - [GET /opportunities](https://canix402-api.compx.io/opportunities): 0.01 USDC — Top 10 aggregated DeFi opportunities ranked by risk then APY # pragma: allowlist secret - [GET /protocols/:protocol/opportunities](https://canix402-api.compx.io/protocols/{protocol}/opportunities): 0.01 USDC — Top 25 DeFi opportunities for a single protocol ranked by risk then APY # pragma: allowlist secret - [GET /opportunities/search](https://canix402-api.compx.io/opportunities/search): 0.01 USDC — Caller-filtered opportunities across supported platforms - [GET /opportunities/personalized](https://canix402-api.compx.io/opportunities/personalized): 0.05 USDC — Top opportunities tuned to a wallet's held assets - [GET /opportunities/:opportunityId/history](https://canix402-api.compx.io/opportunities/:opportunityId/history): 0.01 USDC — Bounded APY/TVL history for one opportunity # pragma: allowlist secret - [POST /eligibility](https://canix402-api.compx.io/eligibility): 0.01 USDC — Wallet eligibility and capacity for selected opportunities # pragma: allowlist secret - [POST /plans](https://canix402-api.compx.io/plans): 0.25 USDC — Compile an allocation intent into an ordered unsigned plan # pragma: allowlist secret - [POST /plans/rebalance](https://canix402-api.compx.io/plans/rebalance): 0.25 USDC — Compile a delta rebalance plan of unsigned groups # pragma: allowlist secret - [POST /policy/validate](https://canix402-api.compx.io/policy/validate): 0.25 USDC — Validate a compiled plan or quotes[] against an operator policy document # pragma: allowlist secret - [GET /positions](https://canix402-api.compx.io/positions): 0.005 USDC — DeFi positions held by an Algorand or Base wallet - [GET /positions/claimable](https://canix402-api.compx.io/positions/claimable): 0.001 USDC — Claimable DeFi rewards across supported protocols - [POST /swaps/transactions](https://canix402-api.compx.io/swaps/transactions): 0.005 USDC — Build a walletless swap transaction group from the winning quote - [GET /protocols/haystack/launches](https://canix402-api.compx.io/protocols/haystack/launches): 0.01 USDC — Haystack tokens still on the bonding curve - [POST /execution/quotes](https://canix402-api.compx.io/execution/quotes): 0.1 USDC — Compile verified transaction shapes into unsigned Algorand groups or Base calldata - [POST /execution/compose](https://canix402-api.compx.io/execution/compose): 0.1 USDC — Compose opt-in → winning swap → enter as unmerged unsigned groups # pragma: allowlist secret - [POST /execution/simulate](https://canix402-api.compx.io/execution/simulate): 0.1 USDC — Simulate compiled unsigned groups for predicted balance and position deltas # pragma: allowlist secret - [POST /sessions](https://canix402-api.compx.io/sessions): 0.25 USDC — Buy a prepaid agent session receipt # pragma: allowlist secret - [POST /sessions/refresh](https://canix402-api.compx.io/sessions/refresh): 0.25 USDC — Refresh a prepaid agent session receipt # pragma: allowlist secret - [POST /watch](https://canix402-api.compx.io/watch): 0.25 USDC — Register a paid wallet watch retainer # pragma: allowlist secret - [POST /watch/refresh](https://canix402-api.compx.io/watch/refresh): 0.25 USDC — Refresh a paid wallet watch retainer # pragma: allowlist secret ## Optional - [Full LLM guide](https://canix402.compx.io/llms-full.txt): self-contained integration reference without following links - [FAQ](https://canix402.compx.io/faq): Algorand, Base, or both; no penalty for omitting a Base address; 402 behavior - [Terms and disclaimer](https://canix402.compx.io/terms): informational-only use, no financial advice - [Support](mailto:kieran@neonforge.ltd): kieran@neonforge.ltd (Neon Forge Ltd)