Listar transacciones

Lea las transacciones de su cuenta. La respuesta es un objeto con data y cursor, no una matriz simple. Utilice un período acotado.

Consulte el Inicio rápido, autenticación y manejo de errores.

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

Filtros

Filtro	Significado
`started_from / updated_from`	Inicio del rango de tiempo (ISO 8601)
`started_to / updated_to`	Fin del rango de tiempo (ISO 8601)
`type`	Filtrar por tipo
`status`	Filtrar por estado
`txid`	Cadena de operación externa exacta
`order_by`	iniciado o actualizado
`limit`	Tamaño de página: 1–500, predeterminado 100
`env`	`prod` (predeterminado). Conserve este valor al abrir y confirmar la solicitud.
`cursor`	Marca de tiempo devuelta como valor_cursor

{
  "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"
  }
}

Página siguiente

Pase el cursor.cursor_value devuelto como la cadena de consulta cursor, no todo el objeto del cursor. Mantenga el mismos filtros y order_by. Para order_by=updated, cursor_field se puede actualizar_at. Deténgase cuando los datos estén vacíos o no se devuelva ningún cursor que avance. Concilie por ID de transacción cuando los registros cambien durante el recorrido.

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'

Filtros​

Página siguiente​

Filtros

Página siguiente