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

نقطة النهاية

POST https://api.lasersell.io/v1/sell

الترويسات

HeaderRequiredDescription
Content-TypeYesMust be application/json
x-api-keyYesYour LaserSell API key

جسم الطلب: BuildSellTxRequest

FieldTypeRequiredDescription
mintstringYesعنوان الرمز (base58).
user_pubkeystringYesالمفتاح العام لمحفظتك (base58).
amount_tokensnumberYesالمبلغ للبيع بالوحدات الذرية للرمز.
outputstringYesأصل المخرجات المطلوب: "SOL" أو "USD1".
slippage_bpsnumberYesأقصى تحمل للانزلاق بنقاط أساس (مثلاً 2000 = 20%).
modestringNoتلميح وضع التوجيه. القيم: "fast", "secure". الافتراضي "fast".
market_contextobjectNoسياق سوق محلول مسبقاً. احذفه للسماح للخادم بالحل تلقائياً.
send_modestringNoوضع إرسال المعاملة: "helius_sender", "astralane", أو "rpc".
tip_lamportsnumberNoإكرامية رسوم أولوية اختيارية بـ lamports.
partner_fee_recipientstringNoمحفظة مستلم رسوم الشريك (مفتاح عام base58).
partner_fee_bpsnumberNoرسوم الشريك بنقاط أساس (أقصى 50 = 0.5%). متبادل الاستبعاد مع partner_fee_lamports.
partner_fee_lamportsnumberNoرسوم الشريك كمبلغ ثابت بـ SOL lamports (أقصى 50,000,000). متبادل الاستبعاد مع partner_fee_bps.

الاستجابة: BuildTxResponse

FieldTypeDescription
txstringمعاملة Solana VersionedTransaction غير موقعة مشفرة بـ Base64.
routeobjectبيانات توجيه وصفية اختيارية.
debugobjectمعلومات تصحيح اختيارية.

مثال curl

curl -X POST https://api.lasersell.io/v1/sell \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "mint": "TOKEN_MINT_ADDRESS",
    "user_pubkey": "YOUR_WALLET_PUBKEY",
    "amount_tokens": 1000000,
    "slippage_bps": 2000,
    "output": "SOL"
  }'

أمثلة حزمة التطوير

import { ExitApiClient, type BuildSellTxRequest } from "@lasersell/lasersell-sdk";

const client = ExitApiClient.withApiKey("YOUR_API_KEY");

const request: BuildSellTxRequest = {
  mint: "TOKEN_MINT_ADDRESS",
  user_pubkey: "YOUR_WALLET_PUBKEY",
  amount_tokens: 1_000_000,
  slippage_bps: 2_000,
  output: "SOL",
};

const response = await client.buildSellTx(request);
console.log("Unsigned tx (base64):", response.tx);

// Or get just the base64 string:
const txB64 = await client.buildSellTxB64(request);

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

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