Saltar al contenido principal

Endpoint

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

Encabezados

EncabezadoRequeridoDescripción
x-api-keyTu clave API de LaserSell

Parámetros de consulta

ParámetroTipoPor defectoDescripción
limitnumber50Número máximo de operaciones a devolver (tope de 200).
offsetnumber0Número de operaciones a omitir para paginación.
mintstringFiltrar resultados por una dirección mint de token específica (base58).
walletstringFiltrar resultados por una clave pública de wallet específica (base58).

Respuesta: TradeHistoryResponse

CampoTipoDescripción
tradesTradeHistoryItem[]Array de registros de operaciones, ordenados por el más reciente primero.
totalnumber | nullNúmero total estimado de operaciones coincidentes para paginación.

Objeto TradeHistoryItem

CampoTipoDescripción
idnumberIdentificador único del registro de operación.
session_idnumberSesión del stream que produjo esta operación.
position_idnumberIdentificador de posición dentro de la sesión.
wallet_pubkeystringClave pública de la wallet que mantuvo la posición (base58).
mintstringDirección mint del token (base58).
entry_quote_unitsnumberCantidad gastada para abrir la posición en unidades atómicas del activo de cotización.
exit_quote_unitsnumber | nullIngresos recibidos al cerrar en unidades atómicas del activo de cotización.
profit_quote_unitsnumber | nullGanancia o pérdida neta en unidades atómicas del activo de cotización.
tokensnumberNúmero de tokens adquiridos en la entrada en unidades atómicas.
exit_reasonstring | nullPor qué se cerró la posición (por ejemplo, target_profit, stop_loss, trailing_stop, manual).
market_kindstring | nullDEX o launchpad donde se operó el token (por ejemplo, PumpFun, RaydiumCpmm).
strategy_target_profit_pctnumber | nullPorcentaje de take profit configurado cuando se abrió la posición.
strategy_stop_loss_pctnumber | nullPorcentaje de stop loss configurado cuando se abrió la posición.
strategy_trailing_stop_pctnumber | nullPorcentaje de trailing stop configurado cuando se abrió la posición.
opened_atstringMarca de tiempo ISO 8601 cuando se abrió la posición.
closed_atstring | nullMarca de tiempo ISO 8601 cuando se cerró la posición.

Ejemplo con curl

curl "https://api.lasersell.io/v1/history?limit=10" \
  -H "x-api-key: YOUR_API_KEY"
Con filtros:
curl "https://api.lasersell.io/v1/history?limit=20&wallet=YOUR_WALLET_PUBKEY&mint=TOKEN_MINT" \
  -H "x-api-key: YOUR_API_KEY"

Respuesta de ejemplo

{
  "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
}

Respuestas de error

Ver Manejo de errores para la especificación completa del formato de error y la lógica de errores reintentables.