Get started

Get your agent a wallet and be Canix-ready in 5 minutes

Copy this into your agent. It creates the Algorand wallet itself, tells you the address to fund, and comes back with one yield recommendation. You never create a wallet and you never paste a seed phrase.

Get me Canix-ready. Canix402 is the paid DeFi yield API at https://canix402.compx.io. You own the wallet. Work through this in order, and wait for me only when I have to send funds or connect a server.

1. Check that the Canix MCP server is connected: https://canix402-mcp.compx.io/mcp (Streamable HTTP). If it is not, show me this config and stop until I say it is connected:

{
  "mcpServers": {
    "canix402": {
      "url": "https://canix402-mcp.compx.io/mcp"
    }
  }
}

That server is walletless. Never put a seed phrase, private key, or mnemonic in its config, and never ask me for mine.

2. Create a new Algorand account yourself. This wallet is yours to operate, separate from any wallet I already have. Use an Algorand MCP account tool you already have (create or generate account). If you do not have one, create the account with the Algorand APIs or algosdk generateAccount. Prefer a tool that stores the key and returns the address only. Show me the address. Do not paste the mnemonic or private key into this chat, and do not ask me to create the wallet in Pera or any other app.

3. Tell me what to send to that address before I do it. Read Canix discovery and quote the live USDC prices. Expect a little ALGO for fees, and Algorand USDC (ASA 31566704). A research call is usually about 0.01 USDC. A 4-hour session is about 0.25 USDC. Algorand alone is enough. Mention Base only if I ask. Then wait while I send it.

4. When the address is funded, use Canix and recommend where that wallet should put its assets. You sign and submit with the wallet you created, using your Algorand MCP tools or the Algorand APIs. If a Canix tool returns a payment requirement or an unsigned transaction group, pay and sign it yourself. Do not hand signing back to me.

5. Stop when three things are true: Canix MCP is connected, you created the agent address and it is funded, and you have made one Canix recommendation. Then say I am Canix-ready and list the address plus those three.

For builders

Use the Caddy gateway URL as your base URL. Discovery, OpenAPI, GET /execution/shapes, and POST /swaps/quote are free; paid data, quote, and swap-transaction routes require x402 USDC payment. Pay on Algorand, on Base, or on both. An Algorand address is enough for Algorand wallet routes. Omitting a Base address does not change rank, eligibility, price, or access.

Option A: Use MCP (recommended for agent hosts)

Connect your MCP client to https://canix402-mcp.compx.io/mcp (Streamable HTTP). Free tools wrap discovery and health; paid tools return payment requirements, then accept paymentSignature on retry. No mnemonic on the MCP server.

{
  "mcpServers": {
    "canix402": {
      "url": "https://canix402-mcp.compx.io/mcp"
    }
  }
}

See MCP for the full tool list and paid-tool flow.

Option B: Direct HTTP

Read discovery and OpenAPI, then call paid routes with x402 headers as below.

1. Read discovery

Fetch the machine-readable endpoint catalog and payment policy.

curl -s https://canix402-api.compx.io/discovery | jq

2. Read OpenAPI

Use OpenAPI for detailed schemas, query params, and x402 metadata.

curl -s https://canix402-api.compx.io/openapi.json | jq '.paths | keys'

3. Probe free routes

Health, metadata, GET /execution/shapes, GET /protocols/haystack/launches/{tokenNum}, and POST /swaps/quote should return 200 without payment headers.

curl -i https://canix402-api.compx.io/health
curl -i https://canix402-api.compx.io/metadata
curl -i https://canix402-api.compx.io/execution/shapes
curl -i https://canix402-api.compx.io/protocols/haystack/launches/175
curl -i https://canix402-api.compx.io/swaps/quote \
  -H 'content-type: application/json' \
  -d '{"address":"YOUR_ALGORAND_ADDRESS","fromAssetId":0,"toAssetId":31566704,"amount":"1000000","type":"fixed-input"}'

4. Call a paid route

First call returns 402 with PAYMENT-REQUIRED. Select an accept by network and retry with a signed payload. Algorand is the first accept and a complete payment on its own. Base (eip155:8453) is optional and uses the same price. Same pattern for opportunities, positions, the Haystack bonding list (GET /protocols/haystack/launches, 0.01 USDC), execution quotes (including a Haystack launch or bonding buy), and POST /swaps/transactions.

1. Preflight Call a paid route without PAYMENT-SIGNATURE. Gateway returns 402 with PAYMENT-REQUIRED.

2. Sign Select an accept by network and sign that USDC payment. Algorand (first accept) is a complete payment on its own. Base is optional.

3. Retry Resend the request with PAYMENT-SIGNATURE. Caddy verifies and settles via facilitator.

4. Success Paid route returns 200 and may include PAYMENT-RESPONSE settlement metadata.

# Opportunities
curl -i https://canix402-api.compx.io/opportunities
curl -i https://canix402-api.compx.io/opportunities \
  -H 'PAYMENT-SIGNATURE: <base64-json-payload>'

# Positions
curl -i 'https://canix402-api.compx.io/positions?address=YOUR_ALGORAND_ADDRESS'
curl -i 'https://canix402-api.compx.io/positions?address=YOUR_ALGORAND_ADDRESS' \
  -H 'PAYMENT-SIGNATURE: <base64-json-payload>'

# Execution quotes (see /examples for full bodies)
curl -i https://canix402-api.compx.io/execution/quotes \
  -H 'content-type: application/json' \
  -d '{"quotes":[{"shapeKey":"mainnet:tinyman:v2:addLiquidity:flexible","input":{"userAddress":"YOUR_ALGORAND_ADDRESS","assetAId":0,"assetAAmount":"1000000","assetBId":31566704,"assetBAmount":"1000000","maxSlippageBps":50}}]}'

# Swap transactions (after free quote + opt-in)
curl -i https://canix402-api.compx.io/swaps/transactions \
  -H 'content-type: application/json' \
  -d '{"address":"YOUR_ALGORAND_ADDRESS","quote":{/* fresh quote */},"slippage":0.005}'

Full copy-paste flows for quotes, positions, and swaps: examples. Payment envelopes: payments.