Canix402

Ask an agent to

• List the top USDC yield opportunities on Algorand
• Show claimable DeFi rewards for my wallet
• Get a swap quote from ALGO to USDC

26 tools

• canix_check_eligibilityuntrusted content

  Check whether a wallet can enter selected opportunities before quoting (POST /eligibility). Pass address and opportunityIds (1–25). Returns canEnter, missingAssets, gates, capacity, suggestedSwap, and…

  address: string, opportunityIds: array, refresh: boolean?, paymentSignature: string?, sessionReceipt: string?

• canix_create_sessionuntrusted content

  Buy a prepaid agent session (POST /sessions, ~0.25 USDC). One x402 payment mints a walletless receipt that unlocks N research calls and M quotes/plans until TTL. Sessions are receipts, not keys. Create/refresh cannot…

  paymentSignature: string?

• canix_create_watchuntrusted content

  Register a paid wallet watch retainer (POST /watch, ~0.25 USDC). Address + thresholds + optional HTTPS webhook. HMAC secret shown once. Canix never stores wallet keys.

  address: string, thresholds: object, webhookUrl: string?, paymentSignature: string?

• canix_get_discoveryread-onlyuntrusted content

  Fetch the discovery catalog via GET /discovery. Free endpoint.

• canix_get_execution_quoteuntrusted content

  Compile one or more unsigned groups (POST /execution/quotes). Algorand shapes return Algorand groups; Morpho shapes (base:morpho:vault:*), Aave shapes (base:aave:v3:*), and Aerodrome shapes (base:aerodrome:v2:*)…

  quotes: array, paymentSignature: string?, sessionReceipt: string?

• canix_get_metadataread-onlyuntrusted content

  Fetch canix402 metadata and endpoint policy matrix via GET /metadata. Free endpoint.

• canix_get_openapiread-onlyuntrusted content

  Fetch the OpenAPI contract via GET /openapi.json. Free endpoint.

• canix_get_opportunity_historyuntrusted content

  Fetch a bounded APY/TVL history series for one opportunity (GET /opportunities/{opportunityId}/history). Window is 1d, 7d, or 30d (default 30d). Empty points until snapshots exist. Includes a stability signal so…

  opportunityId: string, window: string?, paymentSignature: string?, sessionReceipt: string?

• canix_get_personalized_opportunitiesuntrusted content

  Fetch wallet-aware opportunities matched to held assets (GET /opportunities/personalized). Applies eligibility rules so full/gated venues are not recommended as enterable. Use canix_check_eligibility for…

  address: string, limit: integer?, offset: integer?, includeInactive: boolean?, paymentSignature: string?, sessionReceipt: string?

• canix_get_planuntrusted content

  Compile an allocation intent into an ordered unsigned plan (POST /plans). Pass address and budget { assetId, amount } (base units; 0 = ALGO). Optional constraints and opportunityIds. Optional swapSlippage for…

  address: string, budget: object, constraints: object?, opportunityIds: array?, swapSlippage: number?, refresh: boolean?, paymentSignature: string?, sessionReceipt: string?, … (list cut; the site may define more)

• canix_get_positionsuntrusted content

  Fetch Algorand DeFi positions for a wallet via GET /positions. Paid ~0.005 USDC. First call returns PAYMENT-REQUIRED metadata; retry with paymentSignature.

  address: string, paymentSignature: string?, sessionReceipt: string?

• canix_get_protocol_opportunitiesuntrusted content

  List opportunities for a single protocol (GET /protocols/{protocol}/opportunities). Paid ~0.01 USDC.

  protocol: string, limit: integer?, offset: integer?, includeInactive: boolean?, paymentSignature: string?, sessionReceipt: string?

• canix_get_quoteread-onlyuntrusted content

  Get a stateless multi-router swap quote via POST /swaps/quote. Quotes enabled routers in parallel and returns the best expected net out. Optional router forces one adapter. Pass the response data unchanged into…

  address: string, fromAssetId, toAssetId, amount, type: string?, router: string?, slippage: number?, disabledProtocols: array?, … (list cut; the site may define more)

• canix_get_sessionread-onlyuntrusted content

  Read remaining N/M and expiry for a prepaid session receipt (GET /sessions/{sessionId}). Free. Prefer this over the public indexer /transactions showcase.

  sessionId: string

• canix_get_token_pricesread-onlyuntrusted content

  Fetch CompX USD oracle prices for Algorand asset IDs via POST /pricing. Free endpoint; missing prices are returned as null.

  assetIds: array

• canix_get_watchread-onlyuntrusted content

  Read a watch receipt and recent threshold firings (GET /watch/{watchId}). Free. Does not return the HMAC secret.

  watchId: string

• canix_healthread-onlyuntrusted content

  Check canix402 gateway liveness via GET /health. Free endpoint.

• canix_list_claimableuntrusted content

  List claimable DeFi rewards for a wallet via GET /positions/claimable. Returns USD value, network-fee / worth-claiming hints, claim shapeKeys, and claimAllQuotes ready for canix_get_execution_quote. Paid ~0.001 USDC.…

  address: string, paymentSignature: string?, sessionReceipt: string?

• canix_list_execution_shapesread-onlyuntrusted content

  List verified execution shape catalog metadata via GET /execution/shapes (free). Returns shapeKey, requiredInputs, opportunityRole, docsPath, and meta.caveatsDocsPath from the live protocol registry. Catalog only —…

• canix_list_opportunitiesuntrusted content

  List top aggregated DeFi opportunities across supported chains ranked by risk then APY (GET /opportunities). Each row includes chain (algorand|base). Paid ~0.01 USDC.

  limit: integer?, offset: integer?, includeInactive: boolean?, protocol: string?, chain: string?, paymentSignature: string?, sessionReceipt: string?

• canix_optinread-onlyuntrusted content

  Build missing output-asset and application opt-ins via POST /swaps/optin for the winning quote. Free endpoint; pass the quote data object unchanged.

  address: string, quote: object

• canix_refresh_sessionuntrusted content

  Refresh a prepaid session (POST /sessions/refresh, ~0.25 USDC). Resets N/M and TTL in place, or mints a new receipt if the previous one is gone. One-shot only.

  sessionId: string?, paymentSignature: string?

• canix_refresh_watchuntrusted content

  Refresh a paid watch retainer (POST /watch/refresh, ~0.25 USDC). Extends TTL. Optionally rotateSecret. One-shot only.

  watchId: string, rotateSecret: boolean?, paymentSignature: string?

• canix_rotate_watch_secretuntrusted content

  Rotate the watch webhook HMAC secret (POST /watch/{watchId}/rotate-secret). Free. Requires the current secret.

  watchId: string, webhookSecret: string

• canix_search_opportunitiesuntrusted content

  Search/filter opportunities via GET /opportunities/search. Optional chain=algorand|base. Optional assetIds is a comma-separated list of ASA ids (0 = ALGO). Paid ~0.01 USDC.

  platform: string?, type: string?, minApy: number?, maxApy: number?, minTvlUsd: number?, chain: string?, assetIds: string?, limit: integer?, … (list cut; the site may define more)

• canix_swapuntrusted content

  Build unsigned swap transactions via paid POST /swaps/transactions (~0.005 USDC) for the winning quote. Omit paymentSignature for x402 preflight, then retry with the same inputs. Canix does not sign or submit.

  address: string, quote: object, slippage: number, paymentSignature: string?, sessionReceipt: string?