Referral Program — Clawdia API Gateway

How It Works

Register as an affiliate

Call POST /v1/agent-referral/affiliates with your name and wallet address. You'll get a unique affiliate ID.

Create your referral link

Call POST /v1/agent-referral/links with your affiliate ID. You can set a custom referral code.

Share with other agents

When another agent creates an API key with POST /api/keys/create {"ref":"YOUR_CODE"}, they're linked to you.

Earn commissions

Every time a referred agent tops up credits (USDC or XMR), you earn 10% of the USD value. Tracked automatically.

Quick Start

# 1. Register as an affiliate
curl -X POST "https://agent-gateway-kappa.vercel.app/v1/agent-referral/affiliates" \
  -H "Content-Type: application/json" \
  -d '{"name":"MyAgent","wallet_address":"0xYOUR_WALLET"}'

# Response: { "affiliate": { "id": "aff_abc123..." } }

# 2. Create a referral link
curl -X POST "https://agent-gateway-kappa.vercel.app/v1/agent-referral/links" \
  -H "Content-Type: application/json" \
  -d '{"affiliate_id":"aff_abc123...","program_id":"prog_a1085c03136595ba","custom_code":"myagent"}'

# Response: { "code": "myagent", ... }

# 3. Share: agents create keys with your code
curl -X POST "https://agent-gateway-kappa.vercel.app/api/keys/create" \
  -H "Content-Type: application/json" \
  -d '{"ref":"myagent"}'

# 4. Check your earnings
curl "https://agent-gateway-kappa.vercel.app/v1/agent-referral/affiliates/aff_abc123.../dashboard"

Referred Agent Spends	Your Commission (10%)	Credits They Get
$1 USDC	$0.10	500 credits
$5 USDC	$0.50	2,500 credits
$20 USDC	$2.00	10,000 credits
$100 USDC	$10.00	50,000 credits
0.5 XMR (~$175)	~$17.50	~87,500 credits

FAQ

Who can join?

Any agent or developer. No approval needed. Register via the API and start referring immediately.

How are commissions tracked?

When a referred agent tops up credits (USDC or XMR), the system automatically calculates 10% of the USD value and records it as a pending commission against your affiliate account.

When do I get paid?

Commissions accumulate as pending. Payouts are processed periodically to the wallet address you registered with. Minimum payout: $1.

Is there a limit to how much I can earn?

No cap. Refer as many agents as you want. Every credit purchase by a referred agent earns you 10% forever.

Can I see my referral stats?

Yes. Use GET /v1/agent-referral/affiliates/{id}/dashboard for your stats, or GET /v1/agent-referral/links/{code}/stats for per-link breakdowns.

Agent-to-Agent Referral Program