API Reference

Agent DID issuance

Provision a delegated agent identity bound to your institutional principal. Each agent DID carries scoped capability claims and is on-chain revocable. Per PRD §12.8: every action a Hundi-issued agent takes is auditable to the human principal who delegated it.

Closing the loop

Agent-authorized settlement

One click runs the full chain end-to-end: an agent DID is issued, itsquotes.accept capability is verified against an amount and ceiling, and the resulting XRPL Payment is anchored on testnet with the agent attribution embedded in the on-chain Memo. The audit trail is permanent and verifiable on the public ledger.

Live demo

Issue an agent DID

Provisions a delegated agent identity bound to a sample principal DID, with three capability scopes (quotes.read, quotes.accept ceiling $5M, transactions.read) and a 90-day lifetime. v0 issues against an in-memory store; production routes the same call through Postgres + on-chain Trust Registry.

Request

POST /v1/agents
Authorization: Bearer <jwt>
X-Idempotency-Key: 6f0b1-77c3-...

{
  "principal_did":  "did:hundi:0xa12c...",
  "label":          "Treasury copilot — APAC",
  "capabilities": [
    { "scope": "quotes.read",    "ceiling_usd": "100000000.00" },
    { "scope": "quotes.accept",  "ceiling_usd": "5000000.00" },
    { "scope": "transactions.read" }
  ],
  "expires_at": "2026-08-06T00:00:00.000Z"
}

Response

{
  "agent_did":      "did:hundi:agent:0x7b3e...",
  "principal_did":  "did:hundi:0xa12c...",
  "capabilities": [
    { "scope": "quotes.read",    "ceiling_usd": "100000000.00" },
    { "scope": "quotes.accept",  "ceiling_usd": "5000000.00" },
    { "scope": "transactions.read" }
  ],
  "issued_at":  "2026-05-06T12:00:00.247Z",
  "expires_at": "2026-08-06T00:00:00.000Z",
  "revocation_endpoint": "https://api.hundi.network/v1/agents/did:hundi:agent:0x7b3e.../revoke"
}

Revocation is on-chain and propagates to the Trust Registry within 5.2s p99. A revoked agent cannot accept quotes; in-flight quotes by that agent are voided.