메인 콘텐츠로 건너뛰기

​
엔드포인트

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견적 자산 원자 단위로 포지션 개시에 사용한 금액.
exit_quote_unitsnumber | null청산 시 견적 자산 원자 단위로 받은 수익금.
profit_quote_unitsnumber | null견적 자산 원자 단위의 순 수익 또는 손실.
tokensnumber진입 시 취득한 토큰 수(원자 단위).
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
}

​
오류 응답

전체 오류 엔벨로프 사양과 재시도 가능한 오류 로직은 오류 처리를 참조하세요.