# CANIX402

> x402-gated Algorand DeFi data and walletless transaction API for autonomous agents. Pay in USDC micropayments at the gateway edge, fetch normalized APY/TVL data, and build locally signable Haystack swap groups.

Use the **Caddy gateway** (`https://canix402-api.compx.io`) for all API calls. Discovery, execution shapes, strategies list/detail, Haystack quotes, and opt-in preparation are free; data routes, execution quotes, strategy publish/revise/compile, and Haystack swap transaction generation require x402 payment as advertised. 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).

## 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)

## Integration guides

- [Quickstart](https://canix402.compx.io/quickstart): agent onboarding (MCP or direct HTTP)
- [MCP setup](https://canix402.compx.io/mcp): connect to `https://canix402-mcp.compx.io/mcp`, paid-tool paymentSignature retry
- [x402 payment flow](https://canix402.compx.io/x402): preflight 402, sign USDC transfer, 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

## Paid data routes

- [GET /opportunities](https://canix402-api.compx.io/opportunities): 0.01 USDC — Top 10 aggregated DeFi opportunities ranked by APY
- [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 APY
- [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 /positions](https://canix402-api.compx.io/positions): 0.005 USDC — Algorand DeFi positions held by a wallet
- [POST /swaps/transactions](https://canix402-api.compx.io/swaps/transactions): 0.005 USDC — Build a walletless Haystack swap transaction group
- [POST /execution/quotes](https://canix402-api.compx.io/execution/quotes): 0.1 USDC — Compile one or more verified transaction shapes into unsigned Algorand transaction groups
- [POST /strategies](https://canix402-api.compx.io/strategies): 100 USDC — Publish a new strategy (mints NFT, writes Spaces JSON)
- [POST /strategies/{strategyId}](https://canix402-api.compx.io/strategies/{strategyId}): 1 USDC — Revise a strategy composition (NFT holder only, 14-day cooldown)
- [POST /strategies/{strategyId}/compile](https://canix402-api.compx.io/strategies/{strategyId}/compile): 0.1 USDC — Compile a strategy into unsigned execution quotes

## Optional

- [Full LLM guide](https://canix402.compx.io/llms-full.txt): self-contained integration reference without following links
- [FAQ](https://canix402.compx.io/faq): gateway vs upstream, 402 behavior, USDC asset id
- [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)