Cotización de swap en Solana con la Swap API

Get Swap Quote

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://swap-v2.solanatracker.io/rate",
  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/rate"

	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/rate")

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

{
  "amountIn": 1,
  "amountOut": 9181.330823048,
  "minAmountOut": 9089.517514818,
  "currentPrice": 9181.330823048,
  "executionPrice": 9089.517514818,
  "priceImpact": 0.0334641736518774,
  "fee": 0.01,
  "baseCurrency": {
    "decimals": 9,
    "mint": "So11111111111111111111111111111111111111112"
  },
  "quoteCurrency": {
    "decimals": 9,
    "mint": "4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R"
  },
  "platformFee": 9000000,
  "platformFeeUI": 0.009
}

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

rate

Get Swap Quote

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://swap-v2.solanatracker.io/rate",
  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/rate"

	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/rate")

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

{
  "amountIn": 1,
  "amountOut": 9181.330823048,
  "minAmountOut": 9089.517514818,
  "currentPrice": 9181.330823048,
  "executionPrice": 9089.517514818,
  "priceImpact": 0.0334641736518774,
  "fee": 0.01,
  "baseCurrency": {
    "decimals": 9,
    "mint": "So11111111111111111111111111111111111111112"
  },
  "quoteCurrency": {
    "decimals": 9,
    "mint": "4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R"
  },
  "platformFee": 9000000,
  "platformFeeUI": 0.009
}

{
  "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 rate proporciona cotizaciones de precio para swaps de tokens antes de ejecutar una transacción. Úsalo para mostrar a los usuarios la cantidad de salida esperada y el impacto en el precio cuando estén listos para hacer swap.

Este endpoint es solo para cotizaciones previas al swap. No lo uses como API gratuita de precios o datos de mercado. Solicitudes excesivas para fines distintos al swap pueden llevar a rate limiting.

Casos de uso

Cotizaciones pre-swap: Obtén precios precisos antes de ejecutar un swap
Cálculo de slippage: Muestra a los usuarios la salida mínima garantizada
Comprobación de impacto de precio: Valida que el tamaño de la operación sea aceptable

Ejemplos con SDK

import { SolanaTracker } from 'solana-swap';

const tracker = new SolanaTracker('YOUR_API_KEY');

// Get rate quote before swap
const quote = await tracker.getRate({
  from: 'So11111111111111111111111111111111111111112', // SOL
  to: '4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R',
  amount: 1,
  slippage: 10
});

console.log(`Expected: ${quote.amountOut} tokens`);
console.log(`Minimum: ${quote.minAmountOut} tokens`);
console.log(`Price impact: ${(quote.priceImpact * 100).toFixed(2)}%`);

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

from solana_swap import SolanaTracker

tracker = SolanaTracker('YOUR_API_KEY')

# Get rate quote before swap
quote = tracker.get_rate(
    from_token='So11111111111111111111111111111111111111112',
    to_token='4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R',
    amount=1,
    slippage=10
)

print(f"Expected: {quote['amountOut']} tokens")
print(f"Minimum: {quote['minAmountOut']} tokens")
print(f"Price impact: {quote['priceImpact'] * 100:.2f}%")

curl -X GET "https://swap-v2.solanatracker.io/rate?from=So11111111111111111111111111111111111111112&to=4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R&amount=1&slippage=10"

Campos de respuesta

Campo	Tipo	Descripción
`amountIn`	number	Cantidad del token de entrada
`amountOut`	number	Cantidad esperada del token de salida
`minAmountOut`	number	Salida mínima tras slippage
`currentPrice`	number	Precio de mercado actual
`executionPrice`	number	Precio real de ejecución
`priceImpact`	number	Impacto de precio como decimal (0.05 = 5%)
`fee`	number	Fee de trading
`platformFee`	number	Fee de plataforma en lamports
`platformFeeUI`	number	Fee de plataforma en SOL

Respuesta de ejemplo

{
  "amountIn": 1,
  "amountOut": 9181.330823048,
  "minAmountOut": 9089.517514818,
  "currentPrice": 9181.330823048,
  "executionPrice": 9089.517514818,
  "priceImpact": 0.0334641736518774,
  "fee": 0.01,
  "baseCurrency": {
    "decimals": 9,
    "mint": "So11111111111111111111111111111111111111112"
  },
  "quoteCurrency": {
    "decimals": 9,
    "mint": "4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R"
  },
  "platformFee": 9000000,
  "platformFeeUI": 0.009
}

Entender el impacto de precio

El impacto de precio muestra cuánto mueve tu operación el precio de mercado:

< 1% - Excelente liquidez, procede con confianza
1-5% - Aceptable para la mayoría de operaciones
> 5% - Considera una operación más pequeña, otra ruta o esperar a más liquidez

Valida antes del swap

// Check rate before executing swap
async function validateAndSwap(swapParams) {
  // Get quote first
  const quote = await tracker.getRate({
    from: swapParams.from,
    to: swapParams.to,
    amount: swapParams.amount,
    slippage: swapParams.slippage
  });
  
  // Check price impact
  if (quote.priceImpact > 0.05) {
    throw new Error('Price impact too high');
  }
  
  // Execute swap
  return await tracker.swap(swapParams);
}

Errores comunes

Error	Descripción	Solución
`Invalid or missing token address`	Dirección de token inválida	Verifica las direcciones
`Invalid amount`	Cantidad no válida	Asegúrate de que la cantidad sea positiva
`Invalid slippage tolerance`	Slippage no entre 0-100	Establece slippage entre 0-100
`Unable to fetch pools`	No se encuentra liquidez	El token puede no tener pools activos

Próximos pasos

Endpoint Swap

Ejecuta la transacción de 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"

amount

number

requerido

The amount of the base token to convert (in native units, not lamports)

Ejemplo:

1

slippage

number

requerido

The maximum acceptable slippage percentage

Rango requerido: 0 <= x <= 100

Ejemplo:

10

Respuesta

Successful rate quote

amountIn

number

The amount of the source token used for the conversion

Ejemplo:

1

amountOut

number

The amount of the destination token that would be received

Ejemplo:

9181.330823048

minAmountOut

number

The minimum amount of the destination token after applying slippage

Ejemplo:

9089.517514818

currentPrice

number

The current market price for the token pair

Ejemplo:

9181.330823048

executionPrice

number

The actual price at which the trade would be executed

Ejemplo:

9089.517514818

priceImpact

number

The difference between market price and execution price as a fraction

Ejemplo:

0.0334641736518774

fee

number

The trading fee charged for the transaction

Ejemplo:

0.01

baseCurrency

object

Show child attributes

quoteCurrency

object

Show child attributes

platformFee

integer

The fee charged by the platform in lamports

Ejemplo:

9000000

platformFeeUI

number

The platform fee in SOL

Ejemplo:

0.009

Empezar

API Reference

WebSocket

Recursos

Swap API antigua

Cambios recientes

Cotización de swap en Solana con la Swap API

Resumen

Casos de uso

Ejemplos con SDK

Campos de respuesta

Respuesta de ejemplo

Entender el impacto de precio

Valida antes del swap

Errores comunes

Próximos pasos

Endpoint Swap

SDK de JavaScript

Parámetros de consulta

Respuesta

​Resumen

​Casos de uso

​Ejemplos con SDK

​Campos de respuesta

​Respuesta de ejemplo

​Entender el impacto de precio

​Valida antes del swap

​Errores comunes

​Próximos pasos

Endpoint Swap

SDK de JavaScript

Parámetros de consulta

Respuesta

Resumen

Casos de uso

Ejemplos con SDK

Campos de respuesta

Respuesta de ejemplo

Entender el impacto de precio

Valida antes del swap

Errores comunes

Próximos pasos