SDK e API

Referência do SDK TypeScript do Raydium, REST API, IDLs Anchor e padrões de integração para Rust, Python e ferramentas de IA.

Esta página foi traduzida automaticamente por IA. A versão em inglês é a fonte oficial.

Ver versão em inglês →

​

Para quem é este capítulo

Desenvolvedores integrando com Raydium de forma off-chain (TS/JS, Python, backends) ou de outro programa Solana (Rust CPI). Também agentes de IA e integradores de ferramentas de codificação — veja Integração com IA.

Quer executar algo primeiro? Três scripts prontos para usar — swap, deploy de pool CPMM, deploy de pool CLMM — estão em Início rápido. Execute uma transação real em cinco minutos e depois volte aqui para a referência completa.

​

Escolha seu caminho de integração

Cinco caminhos para escolher. O correto depende do que está chamando o Raydium e de quanto controle você precisa.

Caminho	Melhor para	Latência	Lógica personalizada	Linguagens
Trade API	Backends, bots, Blinks — em qualquer lugar onde você queira uma transação construída no servidor	Menor	Limitada (rotas predefinidas)	Qualquer
TypeScript SDK	Aplicações Node/TS e frontends que precisam de acesso total ao builder	Média	Completa	TS / JS
Integração Python	Backends Python e pipelines de ML	Média	Completa (construção manual de instruções)	Python
Rust CPI	Composição de programas que chamam Raydium de forma on-chain	N/A (on-chain)	Completa + componível	Rust
IDL Anchor	Geração de código para linguagens sem suporte de primeira classe (Go, Kotlin, Swift, …)	Variável	Completa	Qualquer com ferramenta de geração Anchor

Se você não tem certeza: backends e bots → Trade API; frontends e aplicativos com controle total → TypeScript SDK; composição on-chain → Rust CPI.

​

Conteúdo do capítulo

TypeScript SDK

@raydium-io/raydium-sdk-v2: instalação, inicialização, módulos principais (pool, farm, launch), construtores de transações, armadilhas comuns.

REST API

Endpoints públicos para informações de pool, informações de mint, preço e transações construídas no servidor. Limites de taxa, orientação de cache, versionamento.

Trade API

Transações de swap construídas no servidor: cotação, construção, assinatura, envio. O padrão de integração sem SDK para backends, bots e Blinks.

IDL Anchor

Onde encontrar o IDL de cada programa, como regenerar clientes a partir dele, o que observar quando o IDL é atualizado.

Rust CPI

Padrões para invocar programas Raydium de outro programa Solana — construção de lista de contas, sementes de assinante, tratamento de erros.

Integração Python

Receitas de solders + solana-py para construir swaps Raydium e operações de pool a partir de Python. Útil para backends e bots.

Integração com IA

Servidor MCP, índice llms.txt, menu de cópia por página, arquivos de contexto pré-construídos para Claude Code / Cursor / Windsurf e outros agentes de codificação.

​

Disciplina de versão

Cada amostra de código em cada página deste capítulo tem um banner no topo:

SDK:       @raydium-io/raydium-sdk-v2 vX.Y.Z
Program:   see /reference/program-addresses
Cluster:   mainnet-beta
Verified:  YYYY-MM-DD

Se você modificar uma amostra de código, atualize o banner.