> ## Documentation Index
> Fetch the complete documentation index at: https://docs.amrood.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Get your first agent payment working in 5 minutes

# Quickstart

## 1. Get Platform API Keys

Sign up at [amrood.io/signup](https://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.

```bash theme={null}
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):

```bash theme={null}
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.

```bash theme={null}
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:

```json theme={null}
{
  "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

```bash theme={null}
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:

```bash theme={null}
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:

```json theme={null}
{
  "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:

```bash theme={null}
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:

```bash theme={null}
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](https://amrood.io) for one-click withdrawals.

That's it. Your agent can now send and receive real INR — with full compliance, identity, and audit built in.