Skip to main content
POST
Request fields accept both camelCase and snake_case. See Request Field Names.
All flag values are the strings "0" and "1", not booleans. "0" is truthy in JavaScript. Compare against "1".

Request

Only chainId and address are required. chainId also accepts "tron", "trx", "ct_195", or "728126428" for TRON. See Supported Chains.

Integration Notes

  • Branch on is_poisoning. It is the aggregate verdict. The individual flags explain why — use them for the warning copy, not for the decision.
  • Compare against the string "1". Every flag is a string. if (row.is_poisoning) is always true.
  • userAddress unlocks the highest-signal check. Without it, mimics_user can only ever be "0" — and that is the check that catches the classic poisoning attack. Send the connected wallet address whenever you have it.
  • "0" means nothing was detected, not that the address is verified safe. It is not a positive safety claim.
  • token_address is {} when you did not ask about a token. Test for the flag’s presence, not for a truthy object.

Headers

X-API-KEY
string
required

Your HashDit API key

Body

application/json

Address and token context for poisoning analysis

chainId
string
required

The network chain ID. EVM numeric IDs, or for TRON any of "tron", "trx", "ct_195", or "728126428". See Supported Chains for the full list.

Example:

"56"

address
string
required

The address to analyze. 0x hex on EVM chains; base58 (T…, 34 characters) on TRON.

Example:

"0x938915fd4b7c188a211113ed655ae1f18c334146"

userAddress
string

Optional. The connected wallet address. When omitted, the mimicry-against-the-user check is skipped.

Example:

"0x938915fd4b7c188a21ad73ed655ae1f18c334146"

tokenAddress
string

Optional. Token contract to check for impersonation. When omitted, the token-mimicry check is skipped.

Example:

"0x55d39f326f99059ff775485246999027b3197956"

Response

Successful response

code
string

Response code. 0 indicates success.

Example:

"0"

status
string

Response status. ok indicates successful operation.

Example:

"ok"

pollAfter
object | null

Reserved for future use.

data
object
property
object | null

Reserved for future use.