الانتقال إلى المحتوى الرئيسي

​
نقطة النهاية

GET https://api.lasersell.io/v1/history

​
الترويسات

HeaderRequiredDescription
x-api-keyYesمفتاح LaserSell API الخاص بك

​
معاملات الاستعلام

ParameterTypeDefaultDescription
limitnumber50أقصى عدد صفقات للإرجاع (حد أقصى 200).
offsetnumber0عدد الصفقات للتخطي للترقيم.
mintstring—تصفية النتائج لعنوان رمز محدد (base58).
walletstring—تصفية النتائج لمفتاح عام محفظة محدد (base58).

​
الاستجابة: TradeHistoryResponse

FieldTypeDescription
tradesTradeHistoryItem[]مصفوفة سجلات الصفقات مرتبة من الأحدث أولاً.
totalnumber | nullالعدد الإجمالي المقدر للصفقات المطابقة للترقيم.

​
كائن TradeHistoryItem

FieldTypeDescription
idnumberمعرف سجل الصفقة الفريد.
session_idnumberجلسة البث التي أنتجت هذه الصفقة.
position_idnumberمعرف المركز ضمن الجلسة.
wallet_pubkeystringالمفتاح العام للمحفظة التي احتفظت بالمركز (base58).
mintstringعنوان الرمز (base58).
entry_quote_unitsnumberالمبلغ المنفق لفتح المركز بالوحدات الذرية لأصل الاقتباس.
exit_quote_unitsnumber | nullالعائد المستلم عند الإغلاق بالوحدات الذرية لأصل الاقتباس.
profit_quote_unitsnumber | nullصافي الربح أو الخسارة بالوحدات الذرية لأصل الاقتباس.
tokensnumberعدد الرموز المكتسبة عند الدخول بالوحدات الذرية.
exit_reasonstring | nullسبب إغلاق المركز (مثل target_profit, stop_loss, trailing_stop, manual).
market_kindstring | nullالتبادل اللامركزي أو منصة الإطلاق التي تُداول عليها الرمز (مثل PumpFun, RaydiumCpmm).
strategy_target_profit_pctnumber | nullنسبة جني الأرباح المحددة عند فتح المركز.
strategy_stop_loss_pctnumber | nullنسبة وقف الخسارة المحددة عند فتح المركز.
strategy_trailing_stop_pctnumber | nullنسبة الوقف المتحرك المحددة عند فتح المركز.
opened_atstringطابع زمني ISO 8601 عند فتح المركز.
closed_atstring | nullطابع زمني ISO 8601 عند إغلاق المركز.

​
مثال curl

curl "https://api.lasersell.io/v1/history?limit=10" \
  -H "x-api-key: YOUR_API_KEY"
مع التصفية: 
curl "https://api.lasersell.io/v1/history?limit=20&wallet=YOUR_WALLET_PUBKEY&mint=TOKEN_MINT" \
  -H "x-api-key: YOUR_API_KEY"

​
مثال استجابة

{
  "trades": [
    {
      "id": 42,
      "session_id": 1001,
      "position_id": 3,
      "wallet_pubkey": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
      "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "entry_quote_units": 500000000,
      "exit_quote_units": 650000000,
      "profit_quote_units": 150000000,
      "tokens": 1000000,
      "exit_reason": "target_profit",
      "market_kind": "PumpFun",
      "strategy_target_profit_pct": 30.0,
      "strategy_stop_loss_pct": 50.0,
      "strategy_trailing_stop_pct": 20.0,
      "opened_at": "2026-03-07T12:00:00Z",
      "closed_at": "2026-03-07T12:30:00Z"
    }
  ],
  "total": 1
}

​
استجابات الأخطاء

راجع معالجة الأخطاء لمواصفات مغلف الأخطاء الكامل ومنطق الأخطاء القابلة لإعادة المحاولة.