Create your self-serve key

​

Mint this wallet's one active API key. An active Builder subscription gets the uncapped-daily, higher-rate-limit tier; any other wallet gets a free key capped at the daily free-tier limit. The plaintext key is returned once here and never again — store it. One active key per wallet: revoke the existing one first (409 otherwise).

Body
required
application/json
  • address
    Type: string
    required

    The wallet to mint the key for. Must match the authenticated session.

  • label
    Type: string
    max length:  
    120

    Optional human label. Defaults to Self-serve — <address>.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/api/builder/key
curl https://www.hoodgrow.com/api/builder/key \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "address": "",
  "label": ""
}'

{
  "id": 42,
  "label": "my agent",
  "keyPrefix": "hg_live_a1b2c3",
  "createdAt": "2026-08-11T14:02:07.881Z",
  "lastUsedAt": null,
  "requestCount": 0,
  "rateLimitPerMinute": 300,
  "dailyLimit": null,
  "webhookUrl": null,
  "revokedAt": null,
  "plaintext": "hg_live_a1b2c3d4e5f60718293a4b5c6d7e8f90"
}

Created.