x402 (machine-payable)

Token safety history (dated daily rows), paid per call via x402

Longitudinal safety series for one token: dated daily grade/score/liquidity/volume/price rows, oldest first — how the risk picture changed, not just where it stands. Rows are recorded whenever a verdict is computed anywhere on the API (recording began 2026-08-16), so any verdict call on a token starts its series. Machine-payable: first call returns HTTP 402 with payment options; pay and retry with the X-PAYMENT header. Charged only when a non-empty series is returned — a token with no recorded history answers an uncharged 404, and server errors are never charged.

get/v1/x402/token-risk/history/{chain}/{address}

Request

  • Base URL: https://hostdefi.com/api
  • URL: https://hostdefi.com/api/v1/x402/token-risk/history/{chain}/{address}
  • Auth: none required

Path parameters

chainstring required

Chain id, e.g. solana, ethereum, base, arbitrum.

addressstring required

Token contract address (Solana mint or 0x EVM address; EVM matches case-insensitively).

Query parameters

limitinteger

Daily rows returned: the most recent N days, oldest first (default 90).

Response

The dated series. Settled payment is confirmed by the X-PAYMENT-RESPONSE header and meta.x402. Each row carries the ts it was computed at.

okboolean
chainstring
addressstring
countinteger

Changes

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