Skip to Content
APISecurity Service APICheck Authorization Security

Check Account Approval Security

1. Overview & Typical Use

Returns a summary and detailed list of token approvals for an account, with emphasis on approvals granted to risky contracts or risky accounts.

  • Typical use: approval risk check, malicious approval detection, token security audit.
  • When not to use: for approval change history use “Get Account Approval Change Records”; to check multi-signature configuration use “Check Multi-Signature Security”.

2. Endpoint & Authentication

GET /api/security/auth/data

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

3. Request

ParameterTypeRequiredDefaultDescription
addressstringYes—Account address to check

4. Response

Top-level

FieldTypeRequiredDescriptionUnit/Precision
approveProjectCountintegerRequiredNumber of approved projects—
approveTokenCountintegerRequiredNumber of approved tokens—
approveAddressCountintegerRequiredNumber of approved addresses—
approveRiskContractCountintegerRequiredNumber of approvals granted to risky contracts—
approveRiskAccountCountintegerRequiredNumber of approvals granted to risky accounts—
approveRiskAddressCountintegerRequiredTotal number of approvals granted to risky addresses—
riskApprovearrayRequiredList of risky approvals; see below—

riskApprove[] elements

FieldTypeRequiredDescriptionUnit/Precision
amountstringRequiredApproved amount—
unlimitedbooleanRequiredWhether this is an unlimited approval—
from_addressstringRequiredApproving address—
to_addressstringRequiredApproved address—
contract_addressstringRequiredToken contract address—
operate_timeintegerRequiredOperation timeMillisecond timestamp
tokenInfoobjectRequiredToken metadata (value schema below)—
projectobjectOptionalProject info (contains id field)—
project_idstringRequiredAddress ID of the approved project—
project_sortintegerRequiredProject sort weight—

tokenInfo object schema (9 common fields):

FieldTypeRequiredDescriptionUnit/Precision
tokenIdstringRequiredToken contract address (Base58); TRX placeholder is _—
tokenAbbrstringRequiredToken abbreviation (e.g. USDT / TRX)—
tokenNamestringRequiredToken name—
tokenDecimalintegerRequiredDecimal precision (required to convert the amount field)—
tokenCanShowintegerRequiredWhether displayable (1 yes / 0 no)—
tokenTypestringRequiredToken type (trc10 / trc20 / trc721 / trc1155)—
tokenLogostringRequiredToken logo URL—
tokenLevelstringRequiredToken level: 0 (UNKNOWN), 1 (NEUTRAL), 2 (OK), 3 (SUSPICIOUS), 4 (UNSAFE)—
vipbooleanRequiredWhether it is a VIP token—

5. Errors

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

  • When there are no risky approvals, riskApprove returns an empty array [] — this is a normal response.
Last updated on: