Canath for ChatGPT & AI Agents

URL: https://www.canath.io
Service: AI-native USDC & EURC transfers and shopping — Circle only, no fiat
API base: https://www.canath.io/api

Read the full AI agent instructions at: https://www.canath.io/ai.html

Paste that URL into ChatGPT, Claude, Gemini, or any AI to activate the Canath agent. The AI will guide users through USDC/EURC transfers and shopping from any merchant — all paid with Circle stablecoins. No fiat, no card, no crypto wallet needed.

What Canath Does

What Canath Does NOT Do

Authentication

All API calls except registration require:

Authorization: Bearer pa_live_XXXXXXXXXXXXXXXXXXXXXXXX

The API key is obtained from POST /api/circle/register and is shown exactly once — store it immediately.

Setup Flow (run once per new user)

Step 1 — Check if account exists

GET https://www.canath.io/api/agents/check?email=jane@example.com
Returns: { "exists": true/false, "firstName": "...", "agentHandle": "PA-..." }

Step 2 — Register or sign in

POST https://www.canath.io/api/circle/register
Content-Type: application/json

{
  "email": "jane@example.com",
  "name": "Jane Smith",
  "password": "their-chosen-password"
}

Returns: { "apiKey": "pa_live_...", "circleWalletId": "...", "handle": "PA-XK7M3Q2R" }

Store the apiKey immediately — it is shown only once. A Circle wallet is created automatically — no extra steps needed.

Step 3 — Fetch and display balance immediately

GET https://www.canath.io/api/circle/balance
Authorization: Bearer pa_live_...
Returns: { "USDC": "123.45", "EURC": "67.89" }

Sending USDC or EURC

Step 1 — Look up the recipient

GET https://www.canath.io/api/circle/lookup?email=john@example.com
Authorization: Bearer pa_live_...

Step 2 — Confirm with the user

Show: "Send 50 USDC to John Smith? Fee: 1.49% = $0.75. They receive 50 USDC. Proceed?"
Wait for explicit YES before proceeding.

Step 3 — Execute the transfer

POST https://www.canath.io/api/circle/transfer
Authorization: Bearer pa_live_...
Content-Type: application/json

{ "recipientEmail": "john@example.com", "amount": 50, "currency": "USDC" }
// or "currency": "EURC" for Euro Coin

View transfer history

GET https://www.canath.io/api/circle/transfers
Authorization: Bearer pa_live_...

Error Reference

StatusMeaningAction
401Invalid API key or wrong passwordCall /api/circle/register again with the correct password
404Recipient not foundAsk user to verify email or create a Canath account at www.canath.io
500Server errorWait briefly and retry once

Key Rules for AI Agents

Full Documentation


Canath · www.canath.io · Circle USDC/EURC: 1.49% · DEX Swap: 0.5% · Cross-Chain Bridge: gas only · No fiat · @canath12