قائمة المعاملات

إقرأ حركات حسابك. الاستجابة هي كائن ذو 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_at. توقف عندما تكون البيانات فارغة أو لا يتم إرجاع المؤشر المتقدم. التسوية بواسطة معرف المعاملة عندما تتغير السجلات أثناء الاجتياز.

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'