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

​
エンドポイント

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

​
ヘッダー

ヘッダー必須説明
x-api-keyはいLaserSell APIキー

​
クエリパラメータ

パラメータ型デフォルト説明
limitnumber50返す取引の最大数（上限200）。
offsetnumber0ページネーション用にスキップする取引数。
mintstring—特定のトークンミントアドレスでフィルター（base58）。
walletstring—特定のウォレット公開鍵でフィルター（base58）。

​
レスポンス: TradeHistoryResponse

フィールド型説明
tradesTradeHistoryItem[]最新のものから順に並んだ取引レコードの配列。
totalnumber | nullページネーション用の一致する取引の推定合計数。

​
TradeHistoryItemオブジェクト

フィールド型説明
idnumber一意の取引レコード識別子。
session_idnumberこの取引を生成したストリームセッション。
position_idnumberセッション内のポジション識別子。
wallet_pubkeystringポジションを保有するウォレット公開鍵（base58）。
mintstringトークンミントアドレス（base58）。
entry_quote_unitsnumberクォートアセットのatomic unitsでのポジションオープン時の使用金額。
exit_quote_unitsnumber | nullクォートアセットのatomic unitsでのクローズ時の受取収益。
profit_quote_unitsnumber | nullクォートアセットのatomic unitsでの純損益。
tokensnumberatomic unitsでのエントリー時の取得トークン数。
exit_reasonstring | nullポジションがクローズされた理由（例: target_profit、stop_loss、trailing_stop、manual）。
market_kindstring | nullトークンが取引されたDEXまたはローンチパッド（例: 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
}

​
エラーレスポンス

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