交易记录查询 API

---

📘 交易记录查询 API 文档

---

一、接口说明

• 接口地址：https://amaxscan.io/api/v1/pg/get/actions

• 请求方式：POST

• 数据格式：application/json

• 功能简介： 本接口用于从 AMAX 区块链中查询指定账户的交易记录，包括所有操作历史、Token 转账、指定代币交易等。

---

二、请求参数说明

参数名	类型	必填	说明
pos	int	是	分页起始位置（推荐使用默认 10，表示从最新开始）
offset	int	是	返回记录数量（建议分页设置，如每页 10 条）
account	string	是	要查询的账户名
search	string	否	关键字搜索，目前保留字段，可为空
startTime	int	否	查询起始时间（Unix 时间戳，单位秒，0 表示不限）
endTime	int	否	查询结束时间（Unix 时间戳，单位秒，0 表示不限）
newAccount	string	否	筛选账户创建操作
redpack	string	否	筛选红包相关操作
symbol	array	否	指定 Token 标识符（如 ["USDT", "AGPU"]）
nftTransfer	string	否	是否筛选 NFT 转移操作
tokenTransfer	string	否	指定为 "transfer" 表示仅查询 token 转账交易

---

三、请求示例

1. 查询所有交易（包括合约交互）：

{
  "pos": 10,
  "offset": 0,
  "account": "useraccount",
  "search": "",
  "startTime": 0,
  "endTime": 0,
  "newAccount": "",
  "redpack": "",
  "symbol": "",
  "nftTransfer": "",
  "tokenTransfer": ""
}

2. 查询账户的所有 Token 转账：

{
  "pos": 10,
  "offset": 0,
  "account": "useraccount",
  "search": "",
  "startTime": 0,
  "endTime": 0,
  "newAccount": "",
  "redpack": "",
  "symbol": "",
  "nftTransfer": "",
  "tokenTransfer": "transfer"
}

3. 查询账户的指定 Token（如 USDT 和 AGPU）转账：

{
  "pos": 10,
  "offset": 0,
  "account": "merchantxpro",
  "tokenTransfer": "transfer",
  "symbol": ["USDT", "AGPU"]
}
{
  "pos": 10,
  "offset": 0,
  "account": "useraccount",
  "search": "",
  "startTime": 0,
  "endTime": 0,
  "newAccount": "",
  "redpack": "",
  "symbol": ["USDT", "AGPU"],
  "nftTransfer": "",
  "tokenTransfer": "transfer"
}

---

四、响应内容说明

查询转账响应格式：

{
  "status": "success",
  "data": [
    {
      "trace_id": "98E8399D9344D2375032BE292E0BDA2FD4B0ED8684F6E728022F79162C59F275",
      "transfer_memo": "coinq hotwallet",
      "precision": "6",
      "block_num": "104209474",
      "contract": "usdt.token",
      "from_account": "depositasset",
      "to_account": "useraccount",
      "token_value": "6.5000000000000000",
      "token_symbol": "USDT",
      "create_time": "1754035193"
    }
  ]
}

字段含义：

字段名	类型	说明
trace_id	string	交易的唯一标识（Hash），可用于去重
transfer_memo	string	转账备注
precision	string	Token 的小数位精度
block_num	string	交易所在的区块编号
contract	string	Token 所属合约名（如 usdt.token）
from_account	string	转出账户名
to_account	string	接收账户名
token_value	string	转账金额（字符串表示，精度依据 precision）
token_symbol	string	Token 标识符（如 USDT）
create_time	string	创建时间（Unix 时间戳）

---

不同查询条件，响应内容不同。

五、注意事项

1. 分页策略：

   • 推荐使用 pos = 10, offset = 0 作为初始请求参数，分页加载更多数据需逐步调整 pos 与 offset。

2. 去重逻辑：

   • 由于链上存在分叉与重复操作，返回结果中可能存在重复交易，建议以 trace_id 作为主键进行唯一性校验。

3. 时间过滤注意：

   • startTime 和 endTime 使用 秒级 Unix 时间戳

   • 若不设置（即为 0），表示不限制时间范围

---

六、使用建议

• 可用于前端账户历史界面加载

• 支持服务端定时拉取数据用于分析、审计或归档

• 如需查询某个地址的收款或付款记录，可通过过滤 from_account 与 to_account 实现分类

测试链地址：https://amaxscan.amaxtest.com/