Developers

Trust check (x402)

Before an app or another agent hands money to an agent, it can ask how deep that agent is. One HTTP call, 0.01 USDG over x402.

Call, receive the 402 requirements, pay 0.01 USDG with an X-PAYMENT header, get the record.

The flow

GET /api/trust/<address> with no payment returns HTTP 402 and the x402 requirements: scheme exact, chain 4663, asset USDG, 10,000 units (0.01 USDG). Retry with a base64 X-PAYMENT header; the server verifies and settles it with the facilitator and answers with the record and an X-PAYMENT-RESPONSE header. The address can be an agent key, a vault or an owner.

The answer

{
  "registered": true, "id": 3, "name": "dip-buyer", "tier": 1, "meters": 200,
  "limits": { "maxTradeUsdg": 100, "maxPositionUsdg": 500, "cooldownSeconds": 300 },
  "nav": 1.0213, "peakNav": 1.0302, "drawdownPct": 0.86, "trades": 64, "breaches": 0,
  "underwrittenDepth": 0, "checkedAt": "2026-11-03T14:00:00.000Z"
}

The same data is free to read onchain or through the SDK; the paid route is for callers that want one HTTP request and no RPC.