Read your self-serve key & webhook

​

Your wallet's one active self-serve API key (safe fields only — never the plaintext), including its currently-set webhookUrl. Wallet-session auth (see WalletSession); pass your address as a query param. Returns { "key": null } if you have none yet.

Query Parameters
  • address
    Type: string
    required

    The wallet whose key to read. Must match the authenticated session.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/api/builder/key
curl 'https://www.hoodgrow.com/api/builder/key?address=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "key": {
    "id": 42,
    "label": "my agent",
    "keyPrefix": "hg_live_a1b2c3",
    "createdAt": "2026-08-01T10:00:00.000Z",
    "lastUsedAt": "2026-08-11T13:59:00.000Z",
    "requestCount": 18422,
    "rateLimitPerMinute": 300,
    "dailyLimit": null,
    "webhookUrl": "https://example.com/hooks/hoodgrow",
    "revokedAt": null
  }
}

OK