> ## 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.

# Solana Swap API 官方 SDK

> Solana Tracker Swap API 官方 SDK，支持 JavaScript、Python、Rust 和 Go。安装、配置并在 Pump.fun、Raydium、Orca 等平台执行兑换。

> [!NOTE]
>
> 这些 SDK 适用于较早的 Solana Tracker Swap API（`swap-v2.solanatracker.io`）。它仍在运行，每笔兑换收取平台费。[Raptor](https://docs.solanatracker.io/cn/raptor/overview.md) 是另一款独立的兑换 API（`raptor.solanatracker.io`），目前免费，无需 API 密钥。

用于将 Solana 代币兑换集成到您的应用程序的官方客户端库。

> [!NOTE]
>
> 所有 SDK 都支持 Pump.fun、PumpSwap、Orca、Meteora、Moonshot、Raydium 和 Jupiter。

## 可用 SDK

> [card] [JavaScript / TypeScript](https://github.com/YZYLAB/solana-swap)
>
> 适用于 Node.js、React、Next.js 和浏览器

> [card] [Python](https://github.com/YZYLAB/solana-swap-python)
>
> 适用于 Python 应用程序和脚本

## 安装

```bash npm theme={null}
npm install solana-swap
```

```bash Python theme={null}
pip install solana-swap
```

## 快速开始

### JavaScript

```javascript theme={null}
import { SolanaTracker } from 'solana-swap';

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

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

// Execute swap
const swap = await tracker.swap({
  from: 'So11111111111111111111111111111111111111112',
  to: '4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R',
  fromAmount: 0.1,
  slippage: 10,
  payer: 'YOUR_WALLET_ADDRESS'
});
```

### Python

```python theme={null}
from solana_swap import SolanaTracker

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

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

# Execute swap
swap = tracker.swap(
    from_token='So11111111111111111111111111111111111111112',
    to_token='4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R',
    from_amount=0.1,
    slippage=10,
    payer='YOUR_WALLET_ADDRESS'
)
```

## React 集成

此示例仅获取报价。请从后端或可以安全签名交易的钱包集成流程执行兑换。

```javascript theme={null}
import { useState } from 'react';
import { SolanaTracker } from 'solana-swap';

function SwapComponent() {
  const [quote, setQuote] = useState(null);
  const tracker = new SolanaTracker(process.env.NEXT_PUBLIC_API_KEY);
  
  async function getQuote(amount) {
    const result = await tracker.getRate({
      from: 'So11111111111111111111111111111111111111112',
      to: '4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R',
      amount: parseFloat(amount),
      slippage: 10
    });
    setQuote(result);
  }
  
  return (
    <div>
      <input 
        type="number" 
        onChange={(e) => getQuote(e.target.value)}
        placeholder="Amount"
      />
      {quote && (
        <div>
          <p>Expected: {quote.amountOut}</p>
          <p>Minimum: {quote.minAmountOut}</p>
          <p>Impact: {(quote.priceImpact * 100).toFixed(2)}%</p>
          <p>Connect a wallet-backed signing flow before executing swaps.</p>
        </div>
      )}
    </div>
  );
}
```

## Python 交易示例

```python theme={null}
from solana_swap import SolanaTracker

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

SOL = 'So11111111111111111111111111111111111111112'
TARGET = '4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R'

# Get quote
quote = tracker.get_rate(
    from_token=SOL,
    to_token=TARGET,
    amount=0.1,
    slippage=10
)

# Check price impact
if quote['priceImpact'] < 0.03:  # < 3%
    # Execute swap
    swap = tracker.swap(
        from_token=SOL,
        to_token=TARGET,
        from_amount=0.1,
        slippage=10,
        payer='YOUR_WALLET',
        priority_fee='auto',
        priority_fee_level='high'
    )
    print(f"Swap completed: {swap['txn']}")
else:
    print("Price impact too high")
```

## 特性

* **零延迟交易** - 亚秒级执行
* **多 DEX 路由** - 跨 DEX 的最佳价格
* **优先级控制** - 手动或自动费用优化
* **自定义费用** - 通过加/扣模式实现盈利
* **灵活金额** - 数值、自动或百分比

## 常见代币地址

| 代币 | 符号 | 地址 |
| - | - | - |
| Wrapped SOL | SOL | `So11111111111111111111111111111111111111112` |
| USD Coin | USDC | `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v` |
| Tether | USDT | `Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB` |
| Raydium | RAY | `4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R` |

## 支持

> [card] [Discord](https://discord.gg/JH2e9rR9fc)
>
> 社区支持

> [card] [电子邮件](mailto:swap-api@solanatracker.io)
>
> 直接 API 支持

> [card] [Swap API](https://docs.solanatracker.io/cn/swap-api/swap.md)
>
> Swap 端点文档

> [card] [Rate API](https://docs.solanatracker.io/cn/swap-api/rate.md)
>
> Rate 端点文档


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