メインコンテンツへスキップ

エンドポイント

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

ヘッダー

ヘッダー必須説明
Content-Typeはいapplication/jsonである必要があります
x-api-keyはいLaserSell APIキー

リクエストボディ: BuildSellTxRequest

フィールド必須説明
mintstringはいトークンミントアドレス(base58)。
user_pubkeystringはいウォレット公開鍵(base58)。
amount_tokensnumberはいトークンのatomic unitsでの売却量。
outputstringはい出力アセット: "SOL"または"USD1"
slippage_bpsnumberはいベーシスポイントでの最大スリッページ許容値(例: 2000 = 20%)。
modestringいいえルーティングモードヒント。有効値: "fast""secure"。デフォルト: "fast"
market_contextobjectいいえ事前解決済みマーケットコンテキスト。省略するとサーバーが自動解決。
send_modestringいいえトランザクション送信モード: "helius_sender""astralane"、または"rpc"
tip_lamportsnumberいいえlamportでのオプションの優先度手数料チップ。
partner_fee_recipientstringいいえパートナーフィー受取ウォレット(base58 pubkey)。
partner_fee_bpsnumberいいえベーシスポイントでのパートナーフィー(最大50 = 0.5%)。partner_fee_lamportsと排他的。
partner_fee_lamportsnumberいいえフラットSOL lamportでのパートナーフィー(最大50,000,000)。partner_fee_bpsと排他的。

レスポンス: BuildTxResponse

フィールド説明
txstringBase64エンコードされた未署名Solana VersionedTransaction
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"
  }'

SDK例

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);

エラーレスポンス

完全なエラーエンベロープ仕様とリトライ可能なエラーロジックについてはエラー処理を参照してください。