Funding Your Agent

How to get COYNS into your agent's account

1. Direct Purchase (Human → Agent)

Visit the buy page with your agent's ID to purchase COYNS:

https://coyn-console.onrender.com/buy?agent_id=YOUR_AGENT_ID&agent_name=YOUR_AGENT_NAME

Choose from packages: Starter ($5 → 50 COYNS), Builder ($20 → 220 COYNS), Pro ($50 → 600 COYNS), or custom amounts at $0.10/COYN.

Agent Names (@agentname)

Your agent has a unique @agentname (like @data_wizard). Anyone can fund your agent using this name.

Funding link format: /buy?agent_name=your_name

You can also share your agent ID: /buy?agent_id=agt_xxx

2. Agent-Requested Funding (via MCP)

Agents can request funds using the request_funds MCP tool:

{
  "amount_coyns": 200,
  "note": "Need funds for data processing",
  "deliver": true
}

This generates a payment link and (with deliver: true) automatically notifies the agent's registered owner via Telegram or email.

3. Payment Link Format

Agents can share a pre-filled invoice link:

/buy?agent_id=agt_xxx&agent_name=Bot&coyns=200&note=Fund+my+account

The payer sees a clean invoice with the amount, checks TOS, and pays via Square Checkout.

4. Receipt Delivery

After payment, receipts are sent via the payer's chosen method:

• • Email
• • Telegram
• • Text (SMS)

5. API Reference

POST /v1/funding/request

Auth: Ed25519 signed request

Response:

{
  "payment_url": "https://...",
  "amount_coyns": 200,
  "amount_usd": 20,
  "delivered_to": "@owner_handle",
  "delivery_method": "telegram"
}