REST API surface

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

​

Mười một dịch vụ sơ lược

​

Chọn một dịch vụ

​

Các quy ước chung

​

Response envelope

{
  "id":      "uuid-v4-per-request",
  "success": true,
  "data":    { ... }
}

{
  "id":      "uuid-v4-per-request",
  "success": false,
  "msg":     "human-readable error string",
  "data":    null
}

​

Xác thực

• Không xác thực — mọi dịch vụ ngoại trừ Forum. Truy cập chúng ẩn danh qua HTTPS.
• Handshake có chữ ký wallet — yêu cầu bởi LaunchLab Forum API. Ký một tin nhắn Solana ed25519 có dạng time:<unix-seconds> bằng wallet của bạn, gửi chữ ký + địa chỉ wallet đến LaunchLab Auth API /request-token, nhận JWT trở lại, và chuyển nó dưới dạng tiêu đề request ray-token trên các lệnh gọi forum tiếp theo.

​

Rate limits

​

Caching và consistency

• Hầu hết các endpoint read của API v3 được cache tại edge trong vòng 5–60 giây; các TTL cụ thể được ghi chú trên trang API Reference của mỗi endpoint.
• Cache được vô hiệu hóa bởi indexer khi nó quan sát các event chạm vào chương trình.
• Trong các reorg lớn hoặc tắc nghẽn, có thể có độ lệch 1–2 slot giữa chế độ xem của API và trạng thái on-chain. SDK và các read RPC trực tiếp luôn cập nhật hơn — nếu client sắp ký một transaction, hãy tái tìm nạp các tài khoản có liên quan qua RPC, không bao giờ tin tưởng một giá trị API mù quáng.

​

Định dạng lỗi

{
  "id":      "uuid-v4-per-request",
  "success": false,
  "msg":     "Pool not found",
  "error":   { "code": 40401, "message": "Pool not found" }
}

​

Quy ước đối số mint-pair

​

Các mô hình client được đề xuất

1. Hydrate một lần, refresh lười biếng. Kéo GET /main/info và GET /mint/list (cả hai trên API v3) lúc app load và cache cục bộ với TTL 1 giờ. Cả hai đều được cache edge nặng nề và hiếm khi thay đổi.
2. Bulk nơi endpoint cho phép. GET /pools/info/ids?ids=… chấp nhận danh sách cách nhau bằng dấu phẩy — tìm nạp mười pool trong một request, không phải mười request.
3. Tránh tìm nạp giá trong đường dẫn hot. GET /mint/price tốt để render UI; không bao giờ vòng lặp nó trong một bot. Đối với bot giao dịch, chạy indexer hoặc đăng ký các event programSubscribe RPC trực tiếp.
4. Gương hoặc proxy cho throughput cao. Bất cứ điều gì vượt quá trần giới hạn được công bố nên được phục vụ từ lớp cache của riêng bạn, không phải trực tiếp từ các host công khai. Các nhà tổng hợp có >120 req/min liên tục chống lại transaction-v1 nên chạy quote / route engine của riêng họ.
5. Re-fetch ngay trước khi ký. Các response API có thể cũ 5–60 giây. Để có một snapshot pool thực sự chính xác tại thời điểm ký, hãy đọc lại các tài khoản có liên quan qua SDK hoặc một lệnh gọi RPC getMultipleAccounts trực tiếp. Coi các giá trị API là một gợi ý tra cứu, không phải một nguồn thanh toán.
6. Sử dụng Transaction API để tích hợp low-friction. Nếu bạn không muốn gói SDK trong client của mình (mobile native, bot trong môi trường hạn chế), Transaction API sẽ trả về một transaction versioned được mã hóa base64 cho người dùng ký. swapResponse nó trả về nhúng một quote — coi nó hợp lệ trong ~30 giây.

​

Tiếp theo bạn sẽ đi đâu

• Tham chiếu endpoint (tương tác) — API Reference. Mỗi dịch vụ có nhóm riêng; bấm vào bất kỳ endpoint nào để xem tham số, hình dạng response, mẫu mã và bảng điều khiển Try-it.
• TypeScript SDK — sdk-api/typescript-sdk. SDK tiêu thụ API v3 bên trong cho một số đường dẫn; để xây dựng transaction nó luôn tái tìm nạp trạng thái từ RPC, không bao giờ tin tưởng API mù quáng.
• Tích hợp Trade API — integration-guides/aggregator. Các mô hình để kết nối thannh khoản Raydium vào một aggregator đa-DEX.
• Tài liệu thân thiện với AI — sdk-api/ai-integration. Con trỏ cho các agent code AI cần gọi những API này.