Buy an API key with a confirmed SOL payment

Verifies the payment signature on-chain (balance delta on the recipient wallet) and mints an API key for the chosen plan. A signature can be redeemed exactly once, for either a web pass or an API key.

post/v1/keys

Request

  • Base URL: https://hostdefi.com/api
  • URL: https://hostdefi.com/api/v1/keys
  • Auth: one of:
    • none
    • API key in header x-api-key

Request body

signaturestring required

Base58 Solana transaction signature of the payment (64–100 chars).

plan'week' | 'month' | 'year' required

week = Builder, month = Pro, year = Scale.

referencestring nullable

Optional base58 reference key that must appear on the transaction.

Response

Key minted. The key is shown only once.

oktrue
apiKeystring

The new key (vx_ + 32 hex chars). Send it as the x-api-key header.

plan'week' | 'month' | 'year'
planName'Builder' | 'Pro' | 'Scale'
quotainteger

Total calls included for the key's lifetime.

batchboolean

Whether the plan may call /v1/token-risk/batch.

expiresAtinteger

Unix ms timestamp when the key expires.

notestring

Changes

No recorded changes to this operation across all 1 revision of this API.