Free contract scanner — branded alias of POST /analyze-token

Identical handler to POST /analyze-token, exposed on the hostdefi.com edge as POST /api/scan. Same request shape, responses, and 100/day/IP fair-use cap.

post/scan

Request

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

Request body

textstring

Token contract address, or an exact token name/ticker. tokenAddress is accepted as an alias.

tokenAddressstring

Alias for text.

Response

Analysis result.

riskLevel'Low' | 'Medium' | 'High'
summarystring
keySignalsstring[]
concerningIndicatorsstring[]
legitimateElementsstring[]
finalTakestring
recommendedActionsstring[]
tokenNamestring nullable
symbolstring nullable
chainstring nullable
contractAddressstring nullable
coinGeckoRankinteger nullable
categoriesstring[]
scorestring

Liquidity-confidence text (legacy field name).

aiConfiguredboolean
subscriberboolean
checkedAtstring date-time
contractDataobject

On-chain contract permission reads (SPL authorities / EVM owner state, holder concentration); shape varies by chain and availability.

aiErrorstring

Present when the AI narrative fell back to the deterministic analysis (reason string).

Changes

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