Agent wrapper

A spend API your agents can read.

Hermes exposes a small machine-readable shell for autonomous agents: discover capabilities, request spend permission, create a prepaid card order, and read ledger state without touching the owner vault directly.

Agent scope cards:issue Owner approval required above policy limit
Discovery Machine readable

Agents should start by reading the manifest. It describes Hermes capabilities, policy language, safe actions, and the OpenAPI file. 

GET /agent-manifest.json
GET /openapi.json
Manifest OpenAPI
Workflow 4 calls
  1. Read balances and policy.
  2. Create a payment intent.
  3. Wait for settlement confirmation.
  4. Create card order and read delivery fields.
Agent request Example 
POST /api/agent-card-issue
Authorization: Bearer hb_agent_...
Idempotency-Key: mission_7fc2_compute_001

{
  "agentId": "research-agent-04",
  "mission": "buy dataset access",
  "cardType": "Hermes Prepaid Visa",
  "country": "US",
  "amount": 25,
  "policy": {
    "merchantScope": ["data", "api"],
    "expiresIn": "24h",
    "approvalAbove": 25
  }
}
Response shell Delivered card 
{
  "cardId": "card_01J...",
  "status": "DELIVERED",
  "amount": 25,
  "currency": "USD",
  "recipient": "research-agent-04",
  "delivery": {
    "type": "code",
    "cardCode": "HB-9K2P-V7M4-R8Q1",
    "pin": "4821"
  },
  "ledger": {
    "paymentStatus": "CONFIRMED",
    "orderStatus": "DELIVERED"
  }
}