빠른 시작 - LaserSell Documentation

사전 요구사항

LaserSell API 키 (여기서 발급).
Solana 키페어 파일 (바이트의 JSON 배열).
Node.js 18+ (TypeScript 예제용) 또는 선호하는 언어의 런타임.

AI로 코딩하시나요? LaserSell MCP 서버를 에디터에 추가하면 AI 어시스턴트가 실시간으로 LaserSell 문서를 검색할 수 있습니다. Claude Code, Claude Desktop, Cursor, Windsurf에서 작동합니다.

예제 1: 매도 트랜잭션 빌드, 서명, 전송

이 예제는 LaserSell API를 호출하여 서명되지 않은 매도 트랜잭션을 빌드하고, 로컬에서 서명하고, Helius Sender를 통해 제출합니다.

import { readFile } from "node:fs/promises";
import { Keypair } from "@solana/web3.js";
import {
  ExitApiClient,
  sendTransaction,
  sendTargetHeliusSender,
  signUnsignedTx,
  type BuildSellTxRequest,
} from "@lasersell/lasersell-sdk";

const apiKey = process.env.LASERSELL_API_KEY!;
const keypairPath = "./keypair.json";

// Load keypair
const raw = await readFile(keypairPath, "utf8");
const keypair = Keypair.fromSecretKey(
  Uint8Array.from(JSON.parse(raw))
);

// Build unsigned tx
const client = ExitApiClient.withApiKey(apiKey);
const request: BuildSellTxRequest = {
  mint: "So11111111111111111111111111111111111111112",
  user_pubkey: keypair.publicKey.toBase58(),
  amount_tokens: 1_000_000,
  slippage_bps: 2_000,
  output: "SOL",
};
const unsignedTxB64 = await client.buildSellTxB64(request);

// Sign locally
const signedTx = signUnsignedTx(unsignedTxB64, keypair);

// Submit
const signature = await sendTransaction(
  sendTargetHeliusSender(),
  signedTx
);
console.log("Signature:", signature);

import asyncio, json
from pathlib import Path
from solders.keypair import Keypair
from lasersell_sdk.exit_api import ExitApiClient, BuildSellTxRequest, SellOutput
from lasersell_sdk.tx import SendTargetHeliusSender, send_transaction, sign_unsigned_tx

async def main():
    api_key = "YOUR_API_KEY"
    keypair_bytes = json.loads(Path("./keypair.json").read_text())
    signer = Keypair.from_bytes(bytes(keypair_bytes))

    client = ExitApiClient.with_api_key(api_key)
    request = BuildSellTxRequest(
        mint="So11111111111111111111111111111111111111112",
        user_pubkey=str(signer.pubkey()),
        amount_tokens=1_000_000,
        slippage_bps=2_000,
        output=SellOutput.SOL,
    )
    unsigned_tx_b64 = await client.build_sell_tx_b64(request)

    signed_tx = sign_unsigned_tx(unsigned_tx_b64, signer)
    signature = await send_transaction(SendTargetHeliusSender(), signed_tx)
    print("Signature:", signature)

asyncio.run(main())

use lasersell_sdk::exit_api::{ExitApiClient, BuildSellTxRequest};
use lasersell_sdk::tx::{SendTarget, sign_unsigned_tx, send_transaction};
use solana_sdk::signature::read_keypair_file;

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let api_key = std::env::var("LASERSELL_API_KEY")?;
    let keypair = read_keypair_file("./keypair.json")?;
    let http = reqwest::Client::new();

    let client = ExitApiClient::with_api_key(&api_key);
    let request = BuildSellTxRequest {
        mint: "So11111111111111111111111111111111111111112".into(),
        user_pubkey: keypair.pubkey().to_string(),
        amount_tokens: 1_000_000,
        output: SellOutput::Sol,
        slippage_bps: 2_000,
        ..Default::default()
    };

    let unsigned_tx_b64 = client.build_sell_tx_b64(&request).await?;
    let signed_tx = sign_unsigned_tx(&unsigned_tx_b64, &keypair)?;
    let signature = send_transaction(&http, &SendTarget::HeliusSender, &signed_tx).await?;
    println!("Signature: {signature}");
    Ok(())
}

package main

import (
    "context"
    "fmt"
    "log"

    "github.com/gagliardetto/solana-go"
    lasersell "github.com/lasersell/lasersell-sdk/go"
)

func main() {
    ctx := context.Background()
    apiKey := "YOUR_API_KEY"
    privateKey, err := solana.PrivateKeyFromSolanaKeygenFile("./keypair.json")
    if err != nil {
        log.Fatal(err)
    }

    client := lasersell.NewExitAPIClientWithAPIKey(apiKey)
    resp, err := client.BuildSellTx(ctx, lasersell.BuildSellTxRequest{
        Mint:         "So11111111111111111111111111111111111111112",
        UserPubkey:   privateKey.PublicKey().String(),
        AmountTokens: 1_000_000,
        Output:       lasersell.SellOutputSOL,
        SlippageBps:  2_000,
    })
    if err != nil {
        log.Fatal(err)
    }

    signedTx, err := lasersell.SignUnsignedTx(resp.Tx, privateKey)
    if err != nil {
        log.Fatal(err)
    }

    sig, err := lasersell.SendTransaction(ctx, nil, lasersell.SendTargetHeliusSender(), signedTx)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println("Signature:", sig)
}

func intPtr(v int) *int    { return &v }
func strPtr(v string) *string { return &v }

예제 2: Exit Intelligence Stream으로 자동 매도

Exit Intelligence Stream에 연결하여 지갑을 모니터링하고 전략 임계값에 도달하면 자동으로 청산을 실행합니다.

매수 전에 스트림을 연결하세요. 스트림은 온체인 토큰 도착을 감시하여 포지션을 감지합니다. 스트림이 연결 및 구성되기 전에 /v1/buy를 호출하면 포지션이 추적되지 않습니다. 항상 스트림을 먼저 시작한 다음 매수 트랜잭션을 제출하세요.

import { readFile } from "node:fs/promises";
import { Keypair } from "@solana/web3.js";
import {
  StreamClient,
  StreamSession,
  sendTransaction,
  sendTargetHeliusSender,
  signUnsignedTx,
} from "@lasersell/lasersell-sdk";

const apiKey = process.env.LASERSELL_API_KEY!;
const raw = await readFile("./keypair.json", "utf8");
const signer = Keypair.fromSecretKey(Uint8Array.from(JSON.parse(raw)));

const client = new StreamClient(apiKey);
const session = await StreamSession.connect(client, {
  wallet_pubkeys: [signer.publicKey.toBase58()],
  strategy: {
    target_profit_pct: 5,
    stop_loss_pct: 1.5,
  },
  deadline_timeout_sec: 45,
  send_mode: "helius_sender",
  tip_lamports: 1000,
});

while (true) {
  const event = await session.recv();
  if (event === null) break;

  if (event.type === "exit_signal_with_tx") {
    const signed = signUnsignedTx(event.message.unsigned_tx_b64, signer);
    const sig = await sendTransaction(sendTargetHeliusSender(), signed);
    console.log("Exit submitted:", sig);
  }
}

import asyncio, json
from pathlib import Path
from solders.keypair import Keypair
from lasersell_sdk.stream.client import StreamClient, StreamConfigure
from lasersell_sdk.stream.session import StreamSession
from lasersell_sdk.tx import SendTargetHeliusSender, send_transaction, sign_unsigned_tx

async def main():
    signer = Keypair.from_bytes(bytes(json.loads(Path("./keypair.json").read_text())))
    client = StreamClient("YOUR_API_KEY")
    session = await StreamSession.connect(
        client,
        StreamConfigure(
            wallet_pubkeys=[str(signer.pubkey())],
            strategy={"target_profit_pct": 5.0, "stop_loss_pct": 1.5},
            deadline_timeout_sec=45,
            send_mode="helius_sender",
            tip_lamports=1000,
        ),
    )

    while True:
        event = await session.recv()
        if event is None:
            break
        if event.type == "exit_signal_with_tx":
            msg = event.message
            signed = sign_unsigned_tx(str(msg["unsigned_tx_b64"]), signer)
            sig = await send_transaction(SendTargetHeliusSender(), signed)
            print("Exit submitted:", sig)

asyncio.run(main())

use lasersell_sdk::stream::client::{StreamClient, StreamConfigure, strategy_config_from_optional};
use lasersell_sdk::stream::session::{StreamSession, StreamEvent};
use lasersell_sdk::stream::proto::ServerMessage;
use lasersell_sdk::tx::{SendTarget, sign_unsigned_tx, send_transaction};
use secrecy::SecretString;
use solana_sdk::signature::read_keypair_file;

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let api_key = std::env::var("LASERSELL_API_KEY")?;
    let keypair = read_keypair_file("./keypair.json")?;
    let http = reqwest::Client::new();

    let client = StreamClient::new(SecretString::new(api_key));
    let configure = StreamConfigure {
        wallet_pubkeys: vec![keypair.pubkey().to_string()],
        strategy: strategy_config_from_optional(
            Some(5.0), Some(1.5), None, None,
        ),
        deadline_timeout_sec: 45,
        send_mode: Some("helius_sender".to_string()),
        tip_lamports: Some(1000),
    };

    let mut session = StreamSession::connect(&client, configure).await?;

    while let Some(event) = session.recv().await {
        if let StreamEvent::ExitSignalWithTx {
            message: ServerMessage::ExitSignalWithTx {
                unsigned_tx_b64, ..
            },
            ..
        } = event
        {
            let signed = sign_unsigned_tx(&unsigned_tx_b64, &keypair)?;
            let sig = send_transaction(&http, &SendTarget::HeliusSender, &signed).await?;
            println!("Exit submitted: {sig}");
        }
    }
    Ok(())
}

package main

import (
    "context"
    "errors"
    "fmt"
    "io"
    "log"

    "github.com/gagliardetto/solana-go"
    lasersell "github.com/lasersell/lasersell-sdk/go"
    "github.com/lasersell/lasersell-sdk/go/stream"
)

func main() {
    ctx := context.Background()
    apiKey := "YOUR_API_KEY"
    privateKey, err := solana.PrivateKeyFromSolanaKeygenFile("./keypair.json")
    if err != nil {
        log.Fatal(err)
    }

    client := stream.NewStreamClient(apiKey)
    sendMode := "helius_sender"
    tipLamports := uint64(1000)
    session, err := stream.ConnectSession(ctx, client, stream.StreamConfigure{
        WalletPubkeys: []string{privateKey.PublicKey().String()},
        Strategy: stream.StrategyConfigMsg{
            TargetProfitPct: 5.0,
            StopLossPct:     1.5,
        },
        DeadlineTimeoutSec: 45,
        SendMode:           &sendMode,
        TipLamports:        &tipLamports,
    })
    if err != nil {
        log.Fatal(err)
    }

    for {
        event, err := session.Recv(ctx)
        if errors.Is(err, io.EOF) {
            break
        }
        if err != nil {
            log.Fatal(err)
        }

        if msg, ok := event.Message.(stream.ExitSignalWithTxServerMessage); ok {
            signedTx, err := lasersell.SignUnsignedTx(msg.UnsignedTxB64, privateKey)
            if err != nil {
                log.Printf("sign failed: %v", err)
                continue
            }
            sig, err := lasersell.SendTransaction(ctx, nil, lasersell.SendTargetHeliusSender(), signedTx)
            if err != nil {
                log.Printf("send failed: %v", err)
                continue
            }
            fmt.Println("Exit submitted:", sig)
        }
    }
}

다음 단계

POST /v1/sell: 매도 트랜잭션의 전체 요청 및 응답 스키마.
Exit Intelligence Stream: WebSocket 스트림 심층 분석.
트랜잭션 서명: 비수탁형 서명 흐름 이해.