列出交易

读取您帐户的交易。响应是一个具有 data 和 cursor 的对象，而不是裸数组。使用有界时期。

请参见快速入门、身份验证】和错误处理】。

GET /api/v1/transactions?env=prod&order_by=started&limit=30
x-api-key: YOUR_API_KEY

过滤器

过滤	意义
started_from / updated_from	时间范围开始 (ISO 8601)
started_to / updated_to	时间范围结束 (ISO 8601)
type	按类型过滤
status	按状态过滤
txid	精确的外部操作字符串
order_by	开始或更新
limit	页面尺寸：1–500，默认100
env	prod（默认）。打开并确认请求时保留该值。
cursor	时间戳作为cursor_value

{
  "data": [
    {
      "id": "c033ceaa-3726-4479-8be3-c9af8a0b2336",
      "txid": "example-order-001",
      "type": "payment",
      "status": "charged",
      "amount": "1000000",
      "currency": "USDT",
      "env": "prod",
      "started": "2026-10-01T10:00:00Z"
    }
  ],
  "cursor": {
    "cursor_field": "started",
    "cursor_value": "2026-10-01T10:00:00Z"
  }
}

下一页

将返回的 cursor.cursor_value 作为查询字符串 cursor 传递，而不是整个游标对象。保持相同的过滤器和 order_by。对于 order_by=updated，cursor_field 可以 update_at。当数据为空或没有返回前进光标时停止。当遍历过程中记录发生更改时，通过事务 ID 进行协调。

curl --get 'https://app.heth.me/api/v1/transactions' \
  --header "x-api-key: $HETH_API_KEY" \
  --data-urlencode 'env=prod' \
  --data-urlencode 'order_by=started' \
  --data-urlencode 'limit=30' \
  --data-urlencode 'cursor=2026-10-01T10:00:00Z'