Crear una transacción de swap en Solana con la Swap API

Build Swap Transaction

curl --request GET \
  --url https://swap-v2.solanatracker.io/swap

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://swap-v2.solanatracker.io/swap",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://swap-v2.solanatracker.io/swap"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://swap-v2.solanatracker.io/swap")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "txn": "BASE64_TX",
  "rate": {
    "amountIn": 1,
    "amountOut": 81.631985,
    "minAmountOut": 73.4687865,
    "currentPrice": 0.012219167460548153,
    "executionPrice": 0.010997250714493338,
    "priceImpact": 0.002517,
    "fee": 0.000005,
    "baseCurrency": {
      "mint": "<string>",
      "decimals": 123
    },
    "quoteCurrency": {
      "mint": "<string>",
      "decimals": 123
    },
    "platformFee": 9000000,
    "platformFeeUI": 0.009
  },
  "timeTaken": 0.016,
  "type": "legacy"
}

{
  "error": "An internal error occurred",
  "details": "Unable to fetch pools for token"
}

{
  "error": "An internal error occurred",
  "details": "Unable to fetch pools for token"
}

GET

swap

Build Swap Transaction

curl --request GET \
  --url https://swap-v2.solanatracker.io/swap

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://swap-v2.solanatracker.io/swap",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://swap-v2.solanatracker.io/swap"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://swap-v2.solanatracker.io/swap")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "txn": "BASE64_TX",
  "rate": {
    "amountIn": 1,
    "amountOut": 81.631985,
    "minAmountOut": 73.4687865,
    "currentPrice": 0.012219167460548153,
    "executionPrice": 0.010997250714493338,
    "priceImpact": 0.002517,
    "fee": 0.000005,
    "baseCurrency": {
      "mint": "<string>",
      "decimals": 123
    },
    "quoteCurrency": {
      "mint": "<string>",
      "decimals": 123
    },
    "platformFee": 9000000,
    "platformFeeUI": 0.009
  },
  "timeTaken": 0.016,
  "type": "legacy"
}

{
  "error": "An internal error occurred",
  "details": "Unable to fetch pools for token"
}

{
  "error": "An internal error occurred",
  "details": "Unable to fetch pools for token"
}

Esta página cubre la antigua Swap API de Solana Tracker en swap-v2.solanatracker.io. Sigue activa y cobra una comisión de plataforma en cada swap. Raptor es una API de swap independiente en raptor.solanatracker.io, actualmente gratuita y sin API key.

Resumen

El endpoint swap construye transacciones de swap de tokens en Solana. Recibes una transacción serializada que firmas y emites con tu wallet.

Este endpoint construye la transacción pero no la ejecuta. Debes firmar y enviar la transacción tú mismo.

Plataformas soportadas

Pump.fun - Tokens de la plataforma de lanzamiento
PumpSwap - Pools de liquidez de Pump.fun
Orca - Liquidez concentrada
Meteora - Pools dinámicos
Moonshot - Nuevos lanzamientos
Raydium - V4 AMM, CPMM, Launchpad
Jupiter - Routing agregado

Ejemplos con SDK

import { SolanaTracker } from 'solana-swap';

const tracker = new SolanaTracker('YOUR_API_KEY', 'YOUR_PRIVATE_KEY');

// Basic swap
const swap = await tracker.swap({
  from: 'So11111111111111111111111111111111111111112', // SOL
  to: '4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R',
  fromAmount: 0.1,
  slippage: 10,
  payer: 'YOUR_WALLET_ADDRESS',
  priorityFee: 0.000005,
  txVersion: 'v0'
});

console.log('Transaction:', swap.txn);

En estos ejemplos de SDK, slippage: 10 significa 10%.

from solana_swap import SolanaTracker

tracker = SolanaTracker('YOUR_API_KEY', 'YOUR_PRIVATE_KEY')

# Basic swap
swap = tracker.swap(
    from_token='So11111111111111111111111111111111111111112',
    to_token='4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R',
    from_amount=0.1,
    slippage=10,
    payer='YOUR_WALLET_ADDRESS',
    priority_fee=0.000005,
    tx_version='v0'
)

print('Transaction:', swap['txn'])

curl -X GET "https://swap-v2.solanatracker.io/swap?from=So11111111111111111111111111111111111111112&to=4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R&fromAmount=0.1&slippage=10&payer=YOUR_WALLET_ADDRESS&priorityFee=0.000005&txVersion=v0"

Parámetros clave

Formatos de cantidad

El parámetro fromAmount acepta:

Numérico: 1, 0.5 - Cantidad exacta
Auto: "auto" - Saldo completo del wallet
Porcentaje: "50%", "25%" - Porcentaje del saldo

Priority fees

// Manual fee
{ priorityFee: 0.000005 }

// Automatic with level
{ 
  priorityFee: "auto",
  priorityFeeLevel: "high" // min, low, medium, high, veryHigh, unsafeMax
}

Fees de partner / referidos

Añade tus propias fees de partner o referidos para monetización:

{
  fee: "YOUR_WALLET:0.1", // 0.1% to your wallet
  feeType: "add" // or "deduct" (SOL only)
}

Ejemplos

Swap con cantidad automática

// Swap entire balance
const swap = await tracker.swap({
  from: 'So11111111111111111111111111111111111111112',
  to: '4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R',
  fromAmount: "auto",
  slippage: 15,
  payer: 'YOUR_WALLET_ADDRESS'
});

Swap con porcentaje

// Swap 50% of balance
const swap = await tracker.swap({
  from: 'TOKEN_ADDRESS',
  to: 'So11111111111111111111111111111111111111112',
  fromAmount: "50%",
  slippage: 10,
  payer: 'YOUR_WALLET_ADDRESS'
});

Swap con fee personalizada

// Add 0.1% fee
const swap = await tracker.swap({
  from: 'So11111111111111111111111111111111111111112',
  to: '4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R',
  fromAmount: 1,
  slippage: 10,
  payer: 'YOUR_WALLET_ADDRESS',
  fee: 'YOUR_FEE_WALLET:0.1',
  feeType: 'add'
});

Estructura de respuesta

{
  "txn": "BASE64_ENCODED_TRANSACTION",
  "rate": {
    "amountIn": 0.1,
    "amountOut": 81.631985,
    "minAmountOut": 73.4687865,
    "currentPrice": 0.012219167460548153,
    "executionPrice": 0.010997250714493338,
    "priceImpact": 0.002517,
    "fee": 0.000005,
    "platformFee": 9000000,
    "platformFeeUI": 0.009
  },
  "timeTaken": 0.016,
  "type": "v0"
}

Fees de la plataforma Solana Tracker

Fee estándar: 0,5% del valor de la transacción

Se deduce de la salida
Se muestra en platformFee (lamports) y platformFeeUI (SOL)
Hay descuentos por volumen

Contacta con swap-api@solanatracker.io para precios por volumen

Errores comunes

Error	Solución
Dirección de token inválida	Verifica que las direcciones sean válidas
Cantidad inválida	Usa número, “auto” o porcentaje
Slippage inválido	Establece entre 0-100
Token sin pools	El token puede estar deslistado
Liquidez insuficiente	Prueba con una cantidad menor

Próximos pasos

Endpoint Rate

Obtén cotizaciones antes de hacer swap

SDK de JavaScript

Instala el SDK

Parámetros de consulta

from

string

requerido

The base token address

Ejemplo:

"So11111111111111111111111111111111111111112"

string

requerido

The quote token address

Ejemplo:

"4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R"

fromAmount

requerido

The amount of the base token to swap. Accepts numeric value, 'auto' for full wallet balance, or percentage like '50%'

Ejemplo:

1

slippage

requerido

Maximum acceptable slippage percentage or 'auto' for dynamic slippage (Beta)

Rango requerido: 0 <= x <= 100

Ejemplo:

10

payer

string

requerido

Public key of the wallet sending the transaction

Ejemplo:

"arsc4jbDnzaqcCLByyGo7fg7S2SmcFsWUzQuDtLZh2y"

priorityFee

Amount in SOL to increase transaction priority or 'auto'

Ejemplo:

0.000005

priorityFeeLevel

enum<string>

predeterminado:medium

Priority level when priorityFee is set to 'auto'

Opciones disponibles:

min,

low,

medium,

high,

veryHigh,

unsafeMax

txVersion

enum<string>

predeterminado:v0

Transaction version

Opciones disponibles:

v0,

legacy

fee

string

Custom fee for your users in format 'WALLET_ADDRESS:PERCENTAGE'

Pattern: ^[a-zA-Z0-9]+:[0-9]+(\.[0-9]+)?$

Ejemplo:

"arsc4jbDnzaqcCLByyGo7fg7S2SmcFsWUzQuDtLZh2y:0.1"

customTip

string

Custom tip for Jito or similar services in format 'WALLET_ADDRESS:SOL_AMOUNT'

Pattern: ^[a-zA-Z0-9]+:[0-9]+(\.[0-9]+)?$

feeType

enum<string>

predeterminado:add

Fee application type. 'deduct' option is only used when the from address is SOL

Opciones disponibles:

add,

deduct

onlyDirectRoutes

boolean

predeterminado:false

Disable multi-hop swaps

Respuesta

Successful swap transaction

txn

string

Base64 encoded transaction

Ejemplo:

"BASE64_TX"

rate

object

Show child attributes

timeTaken

number

Time taken for the operation in seconds

Ejemplo:

0.016

type

enum<string>

Transaction type

Opciones disponibles:

v0,

legacy

Ejemplo:

"legacy"

Empezar

API Reference

WebSocket

Recursos

Swap API antigua

Cambios recientes

Crear una transacción de swap en Solana con la Swap API

Resumen

Plataformas soportadas

Ejemplos con SDK

Parámetros clave

Formatos de cantidad

Priority fees

Fees de partner / referidos

Ejemplos

Swap con cantidad automática

Swap con porcentaje

Swap con fee personalizada

Estructura de respuesta

Fees de la plataforma Solana Tracker

Errores comunes

Próximos pasos

Endpoint Rate

SDK de JavaScript

Parámetros de consulta

Respuesta

​Resumen

​Plataformas soportadas

​Ejemplos con SDK

​Parámetros clave

​Formatos de cantidad

​Priority fees

​Fees de partner / referidos

​Ejemplos

​Swap con cantidad automática

​Swap con porcentaje

​Swap con fee personalizada

​Estructura de respuesta

​Fees de la plataforma Solana Tracker

​Errores comunes

​Próximos pasos

Endpoint Rate

SDK de JavaScript

Parámetros de consulta

Respuesta

Resumen

Plataformas soportadas

Ejemplos con SDK

Parámetros clave

Formatos de cantidad

Priority fees

Fees de partner / referidos

Ejemplos

Swap con cantidad automática

Swap con porcentaje

Swap con fee personalizada

Estructura de respuesta

Fees de la plataforma Solana Tracker

Errores comunes

Próximos pasos