메인 콘텐츠로 건너뛰기
이 매수를 Exit Intelligence Stream으로 추적하려면 매수 트랜잭션을 제출하기 전에 반드시 스트림을 연결해야 합니다. 스트림은 실시간으로 온체인 토큰 도착을 관찰하여 새 포지션을 감지합니다. 매수가 랜딩될 때 스트림이 연결되어 있지 않으면 포지션이 추적되지 않으며 청산 신호가 생성되지 않습니다.

​
엔드포인트

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

​
헤더

헤더필수설명
Content-Type예application/json이어야 합니다
x-api-key예LaserSell API 키

​
요청 본문: BuildBuyTxRequest

필드타입필수설명
mintstring예매수할 토큰 민트 주소 (base58).
user_pubkeystring예지갑 공개키 (base58).
amountnumber아니오*사람이 읽을 수 있는 지출 금액 (예: SOL의 경우 0.1, USD1의 경우 10.0). amount_in_total과 상호 배타적.
amount_in_totalnumber아니오*입력 자산 원자 단위의 지출 금액 (예: SOL의 경우 lamport). amount과 상호 배타적.
slippage_bpsnumber예최대 슬리피지 허용 범위(베이시스 포인트) (예: 2000 = 20%).
inputstring아니오입력 자산: "SOL" (기본값) 또는 "USD1".
modestring아니오라우팅 모드 힌트. 유효 값: "fast", "secure". 기본값: "fast".
send_modestring아니오트랜잭션 전송 모드: "helius_sender", "astralane" 또는 "rpc".
tip_lamportsnumber아니오선택적 우선 수수료 팁(lamport).
partner_fee_recipientstring아니오파트너 수수료 수신 지갑 (base58 공개키).
partner_fee_bpsnumber아니오파트너 수수료(베이시스 포인트) (최대 50 = 0.5%). partner_fee_lamports와 상호 배타적.
partner_fee_lamportsnumber아니오고정 SOL lamport 파트너 수수료 (최대 50,000,000). partner_fee_bps와 상호 배타적.
* amount 또는 amount_in_total 중 정확히 하나를 제공해야 합니다. amount는 input 자산에 따라 원자 단위로 자동 변환됩니다 (SOL: 10^9, USD1: 10^6).

​
응답: BuildTxResponse

필드타입설명
txstringBase64로 인코딩된 서명되지 않은 Solana VersionedTransaction.
routeobject선택적 라우팅 메타데이터.
debugobject선택적 디버그 정보.

​
curl 예제

사람이 읽을 수 있는 amount 사용: 
curl -X POST https://api.lasersell.io/v1/buy \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "mint": "TOKEN_MINT_ADDRESS",
    "user_pubkey": "YOUR_WALLET_PUBKEY",
    "amount": 0.1,
    "slippage_bps": 2000,
    "input": "SOL"
  }'
원자 단위 amount_in_total 사용: 
curl -X POST https://api.lasersell.io/v1/buy \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "mint": "TOKEN_MINT_ADDRESS",
    "user_pubkey": "YOUR_WALLET_PUBKEY",
    "amount_in_total": 100000000,
    "slippage_bps": 2000,
    "input": "SOL"
  }'

​
SDK 예제

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

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

const request: BuildBuyTxRequest = {
  mint: "TOKEN_MINT_ADDRESS",
  user_pubkey: "YOUR_WALLET_PUBKEY",
  amount: 0.1, // 0.1 SOL
  slippage_bps: 2_000,
};

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

​
오류 응답

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