> ## Documentation Index
> Fetch the complete documentation index at: https://docs.solanatracker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Cotización de swap en Solana con la Swap API

> Obtén una cotización de un swap de tokens de Solana con GET /rate: output esperado e impacto en el precio. Úsala antes de un swap, no como API de precios.

> [!NOTE]
>
> 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](https://docs.solanatracker.io/es/raptor/overview.md) 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.

> [!WARNING]
>
> 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

```javascript JavaScript theme={null}
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%.

```python Python theme={null}
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}%")
```

```bash cURL theme={null}
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

```json theme={null}
{
  "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

```javascript theme={null}
// 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

> [card] [Endpoint Swap](https://docs.solanatracker.io/es/swap-api/swap.md)
>
> Ejecuta la transacción de swap

> [card] [SDK de JavaScript](https://github.com/YZYLAB/solana-swap)
>
> Instala el SDK


## OpenAPI

````yaml openapi.json GET /rate
openapi: 3.1.0
info:
  title: Solana Tracker - Swap API
  description: >-
    The Solana Tracker Swap API offers seamless, zero-delay access to Solana's
    dynamic token marketplace. Trade tokens the moment they launch with our
    high-performance infrastructure. Supports Pump.fun, PumpSwap, Moonshot,
    Boop, Orca, Meteora, Raydium, and any pool supported by Jupiter.
  version: 2.0.0
  contact:
    name: Solana Tracker Support
    email: swap-api@solanatracker.io
    url: https://discord.com/invite/JH2e9rR9fc
  x-fees:
    standard: 0.5%
    highVolume: 0-0.5%
servers:
  - url: https://swap-v2.solanatracker.io
    description: Production server
security: []
tags:
  - name: Swap
    description: Token swap operations
  - name: Rate
    description: Rate and price quote operations
externalDocs:
  description: Full API Documentation
  url: https://docs.solanatracker.io/swap-api
paths:
  /rate:
    get:
      summary: Get Swap Quote
      description: Get live swap rates for any Solana token.
      operationId: getRate
      parameters:
        - name: from
          in: query
          required: true
          description: The base token address
          schema:
            type: string
            example: So11111111111111111111111111111111111111112
        - name: to
          in: query
          required: true
          description: The quote token address
          schema:
            type: string
            example: 4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R
        - name: amount
          in: query
          required: true
          description: >-
            The amount of the base token to convert (in native units, not
            lamports)
          schema:
            type: number
            example: 1
        - name: slippage
          in: query
          required: true
          description: The maximum acceptable slippage percentage
          schema:
            type: number
            minimum: 0
            maximum: 100
            example: 10
      responses:
        '200':
          description: Successful rate quote
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RateResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    RateResponse:
      type: object
      properties:
        amountIn:
          type: number
          description: The amount of the source token used for the conversion
          example: 1
        amountOut:
          type: number
          description: The amount of the destination token that would be received
          example: 9181.330823048
        minAmountOut:
          type: number
          description: The minimum amount of the destination token after applying slippage
          example: 9089.517514818
        currentPrice:
          type: number
          description: The current market price for the token pair
          example: 9181.330823048
        executionPrice:
          type: number
          description: The actual price at which the trade would be executed
          example: 9089.517514818
        priceImpact:
          type: number
          description: >-
            The difference between market price and execution price as a
            fraction
          example: 0.0334641736518774
        fee:
          type: number
          description: The trading fee charged for the transaction
          example: 0.01
        baseCurrency:
          type: object
          properties:
            decimals:
              type: integer
              description: Base token decimals
              example: 9
            mint:
              type: string
              description: Base token mint address
              example: So11111111111111111111111111111111111111112
        quoteCurrency:
          type: object
          properties:
            decimals:
              type: integer
              description: Quote token decimals
              example: 9
            mint:
              type: string
              description: Quote token mint address
              example: 4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R
        platformFee:
          type: integer
          description: The fee charged by the platform in lamports
          example: 9000000
        platformFeeUI:
          type: number
          description: The platform fee in SOL
          example: 0.009
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: Error message
          examples:
            - An internal error occurred
            - Invalid or missing 'from' or 'to' token address
            - Invalid amount
            - Invalid slippage tolerance (should be between 0 and 100%)
        details:
          type: string
          description: Additional error details
          examples:
            - Unable to fetch pools for token
            - Token has no pools
            - No pools with liquidity found

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.