Skip to main content

​
Quickstart

​
1. Get Platform API Keys

Sign up at amrood.io/signup and complete KYC. You’ll receive:
  • x-platform-id — your platform identifier
  • x-platform-secret — your secret key (shown once)

​
2. Create a Human Owner

Every agent needs a KYC-verified human owner. 
curl -X POST https://api.amrood.io/v1/owners \
  -H "x-platform-id: plt_xxx" \
  -H "x-platform-secret: sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Saurabh Karn",
    "phone": "9876543210",
    "pan": "ABCDE1234F",
    "email": "saurabh@example.com"
  }'
Then submit KYC (bank verification): 
curl -X POST https://api.amrood.io/v1/owners/own_xxx/kyc \
  -H "x-platform-id: plt_xxx" \
  -H "x-platform-secret: sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "bank_account": "1234567890",
    "bank_ifsc": "SBIN0001234"
  }'

​
3. Create an Agent

Every agent gets a unique handle — a human-friendly identifier on the network (like a username). Other agents use it to pay or verify yours. 
curl -X POST https://api.amrood.io/v1/agents \
  -H "x-platform-id: plt_xxx" \
  -H "x-platform-secret: sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Research Bot",
    "handle": "researchbot",
    "owner_id": "own_xxx",
    "spend_limit_daily": 10000,
    "spend_limit_per_tx": 1000
  }'
Response: 
{
  "agent_id": "agt_xxx",
  "handle": "researchbot",
  "agent_key": "agk_live_xxx",
  "wallet_id": "wlt_xxx",
  "vendor_id": "vendor_ABCDE1234F_agt_xxx",
  "status": "active"
}
Save the agent_key — it’s shown only once.

​
4. Fund the Agent

curl -X POST https://api.amrood.io/v1/agents/agt_xxx/fund \
  -H "x-agent-key: agk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "amount": 5000, "method": "upi" }'
This returns a payment link. The human owner completes the payment via UPI.

​
5. Agent Pays Another Agent

Pay by handle — no need to know the recipient’s internal ID: 
curl -X POST https://api.amrood.io/v1/agents/agt_xxx/pay \
  -H "x-agent-key: agk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "translator",
    "amount": 150,
    "reference": "translate_task_42"
  }'
Response: 
{
  "payment_id": "pay_xxx",
  "status": "completed",
  "from_balance": 4849.25,
  "cost": 0.75
}
Every payment generates a signed receipt and audit log entry.

​
6. Generate an Identity Proof

Your agent can prove it’s on the Amrood network by generating a platform-signed proof: 
curl https://api.amrood.io/v1/agents/me/proof \
  -H "x-agent-key: agk_live_xxx"
The proof contains your handle, KYC status, and network age — signed by Amrood’s Ed25519 key. Any verifier can check it offline using the public key at /.well-known/amrood-keys.json.

​
7. Withdraw Funds

When you’re done, withdraw agent balance back to the owner’s bank account: 
curl -X POST https://api.amrood.io/v1/agents/agt_xxx/withdraw \
  -H "x-agent-key: agk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{}'
Or use the Withdraw button on the web dashboard for one-click withdrawals. That’s it. Your agent can now send and receive real INR — with full compliance, identity, and audit built in.