Get Account Approval Change Records

1. Overview & Typical Use

Query the token approval (Approve) change history for a specified account. Supports querying by approval records or transfer records.

Typical use: track approval amount changes, review approval usage, contract approval security analysis.
When not to use: for current approval list use “Get Approval List”.
limit maximum is 50.

GET /api/account/approve/change

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

Parameter	Type	Required	Default	Description
`contract_address`	string	Yes	—	Contract address
`from_address`	string	Yes	—	Initiator address
`to_address`	string	Yes	—	Recipient address
`start`	integer	No	`0`	Starting offset
`limit`	integer	No	`10`	Page size, max 50
`type`	string	No	`approve`	Record type. `approve`: approval records; `transfer`: transfer records

Top-level

Field	Type	Required	Description	Unit/Precision
`total`	integer	Required	Total record count	—
`rangeTotal`	integer	Required	Total count within the filtered range	—
`data`	array	Required	Change records array; see below	—
`contractMap`	object	Required	Address → boolean map of whether it is a contract (may be empty object)	—
`contractInfo`	object	Optional	Contract address → label info; may be empty object `{}`, not returned in some responses; value schema below	—

data[] elements

Field	Type	Required	Description	Unit/Precision
`hash`	string	Required	Transaction hash	—
`block`	integer	Required	Block height	—
`date_created`	integer	Required	Record creation time	ms timestamp
`from_address`	string	Required	Initiator address	—
`fromAddressTag`	string	Optional	Initiator address label; only present when the initiator has a public label (verified 2026-06-02: key absent for accounts without a label)	—
`owner_address`	string	Required	Owner address	—
`to_address`	string	Required	Recipient address	—
`toAddressTag`	string	Optional	Recipient address label; only present when the recipient has a public label (verified 2026-06-02: key absent for accounts without a label)	—
`contract_address`	string	Required	Contract address	—
`type`	string	Required	Record type: `approve` or `transfer`	—
`amount_str`	string	Required	Approval/transfer amount (raw value string)	Requires tokenInfo.tokenDecimal to convert
`unlimited`	boolean	Required	Whether it is an unlimited approval	—
`revert`	boolean	Required	Whether the transaction was reverted	—
`confirmed`	boolean	Required	Whether confirmed	—
`contract_ret`	string	Required	Contract execution result	—
`tokenInfo`	object	Required	Token metadata (value schema below)	—

contractInfo[<addr>] object schema (8 fields):

Field	Type	Required	Description
`tag1`	string	Required	Primary label (project name / contract name / exchange name)
`tag1Url`	string	Required	URL of the primary label (may be an empty string)
`name`	string	Required	Formal contract / project name
`isToken`	boolean	Required	Whether it is a token contract (`true` / `false`)
`vip`	boolean	Required	Whether it is a VIP entity (`true` / `false`)
`risk`	boolean \| string	Required	Risk label; most endpoints return boolean, some return a string risk type (`blacklist` / `fraud`, etc.)
`publicTagDesc`	string	Required	Public label description; empty string for most accounts
`publicTag`	string	Optional	Public label (e.g. `"USDT Token"` / `"Binance"`); returned only for well-known entities or certain endpoints

tokenInfo object schema (9 common fields + issuerAddr):

Field	Type	Required	Description	Unit/Precision
`tokenId`	string	Required	Token contract address (Base58); TRX placeholder is `_`	—
`tokenAbbr`	string	Required	Token abbreviation (e.g. `USDT` / `TRX`)	—
`tokenName`	string	Required	Token name	—
`tokenDecimal`	integer	Required	Decimal precision (required to convert the `amount` field)	—
`tokenCanShow`	integer	Required	Whether displayable (`1` yes / `0` no)	—
`tokenType`	string	Required	Token type (`trc10` / `trc20` / `trc721` / `trc1155`)	—
`tokenLogo`	string	Required	Token logo URL	—
`tokenLevel`	string	Required	Token level	—
`vip`	boolean	Required	Whether it is a VIP token	—
`issuerAddr`	string	Required	Issuer address (Base58)	—

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

Empty result is not an error: no matching change records returns 200 + data: [], which is a normal response.