Quickstart

1. Get Platform API Keys

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.

Getting Started

Payments

Concepts

Governance

Events

Use Cases

Quickstart

Quickstart

1. Get Platform API Keys

2. Create a Human Owner

3. Create an Agent

4. Fund the Agent

5. Agent Pays Another Agent

6. Generate an Identity Proof

7. Withdraw Funds

​Quickstart

​1. Get Platform API Keys

​2. Create a Human Owner

​3. Create an Agent

​4. Fund the Agent

​5. Agent Pays Another Agent

​6. Generate an Identity Proof

​7. Withdraw Funds

Quickstart

1. Get Platform API Keys

2. Create a Human Owner

3. Create an Agent

4. Fund the Agent

5. Agent Pays Another Agent

6. Generate an Identity Proof

7. Withdraw Funds