Skip to Content
APISecurity Service APICheck Transaction Security

Check Transaction Security

1. Overview & Typical Use

Performs a per-transaction risk analysis on one or more transaction hashes, identifying zero-value transfers, risky tokens, risky addresses, and same-tail address impersonation attacks.

  • Typical use: batch transaction risk check, zero-value attack detection, tail-number impersonation attack identification.
  • When not to use: to check account security use “Check Account Security”; for transaction details use “Get Transaction Details by Hash”.

2. Endpoint & Authentication

GET /api/security/transaction/data

For Base URL and authentication, see Common Network & Authentication.

3. Request

ParameterTypeRequiredDefaultDescription
hashesstringYesOne or more transaction hashes, comma-separated

4. Response

The response is a map keyed by transaction hash; each record contains:

FieldTypeRequiredDescriptionUnit/Precision
riskTokenbooleanRequiredWhether a risky token is involved
zeroTransferbooleanRequiredWhether the transfer amount is zero
riskAddressbooleanRequiredWhether a risky address is involved
sameTailAttachbooleanRequiredWhether this is a same-tail impersonation attack
riskTransactionbooleanRequiredWhether the transaction is flagged as risky overall

5. Errors

For HTTP status codes, see Common Errors. Key points for this endpoint:

  • When hashes contains invalid hashes, invalid entries are silently ignored and only valid results are returned.
  • When no valid hashes are provided, the response is 200 + {} — this is a normal response.
Last updated on: