KyroKyro Docs
ReferenceAPI Reference

Get a wallet's verified trust graph

GET
/api/v1/trust/{wallet}

Returns the wallet's trust graph: verified transaction-backed edges to peers, a point-in-time trust summary and network metrics computed from those edges at read time, anomaly summaries and plain-language explanations. Anomaly entries are sanitized for public consumption: per-anomaly details is always an empty object and suspiciousWallets is always an empty list. Costs 1 rate unit.

Authorization

bearerApiKey
AuthorizationBearer <token>

Optional Kyro API key: Authorization: Bearer kyro_live_.... Anonymous access (no header) works on every endpoint with a lower rate limit (20 units/minute per IP vs 120 units/minute per key). Keys are validated only when the header is present; a malformed, unknown or revoked key is rejected with 401 INVALID_KEY.

In: header

Path Parameters

wallet*string

EVM wallet address. 0x + 40 hex characters (case-insensitive).

Match^0x[a-fA-F0-9]{40}$

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/trust/0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
{  "ok": true,  "version": "v1",  "data": {    "wallet": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",    "trustGraph": {      "walletAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",      "edges": [],      "snapshot": {        "walletAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",        "trustedPeerCount": 0,        "strongestConnectionWallet": null,        "strongestConnectionWeight": 0,        "reciprocalCount": 0,        "networkHealth": "isolated",        "totalTrustWeight": 0,        "propagatedTrustScore": 0,        "trustConfidence": 0,        "anomalyScore": 0,        "maturityReason": "No verified transaction-backed trust edges are available yet.",        "topTrustedPeers": [],        "createdAt": null,        "updatedAt": null      },      "anomalies": [],      "reciprocalPeers": [],      "strongestPeers": [],      "metrics": {        "trustedPeerCount": 0,        "reciprocalCount": 0,        "totalTrustWeight": 0,        "strongestConnectionWeight": 0,        "networkHealth": "isolated",        "relationshipDiversity": 0,        "networkMaturity": "isolated",        "trustLevel": "Isolated",        "propagatedTrustScore": 0,        "trustConfidence": 0,        "anomalyScore": 0,        "maturityReason": "No verified transaction-backed trust edges are available yet.",        "suspicious": false      },      "explanations": [        "Network currently isolated.",        "No verified transaction-backed trust edges are available yet."      ]    }  }}