Chuyển đến nội dung chính

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.

Trang này được dịch tự động bằng AI. Phiên bản tiếng Anh là bản chính thức.Xem bản tiếng Anh →
Mọi endpoint trên trang này đều có một panel Thử nó được cấp quyền bởi sân chơi OpenAPI của Mintlify. Sân chơi chạy trong trình duyệt của bạn và truy cập trực tiếp đến các máy chủ sản xuất (hoặc devnet) trực tiếp. Hãy đọc phần Xác thực trước khi gửi các yêu cầu cần chữ ký ví.

​
Danh mục dịch vụ

Raydium vận hành mười một dịch vụ HTTP công khai. Mỗi dịch vụ được ghi chép dưới dạng một nhóm riêng trong cây điều hướng ở bên trái.
Dịch vụHost MainnetHost DevnetChức năng
API v3api-v3.raydium.ioapi-v3-devnet.raydium.ioPool / mint / config / chain-info — API đọc chính tắc mà giao diện người dùng và SDK dựa vào.
Transaction APItransaction-v1.raydium.iotransaction-v1-devnet.raydium.ioXây dựng giao dịch swap / liquidity phía máy chủ. Điểm vào của bộ tập hợp.
Perps APIapi-perp-v1.raydium.io—Cài đặt, siêu dữ liệu tài sản, lựa chọn RPC cho giao diện Raydium Perps.
LaunchLab Mint APIlaunch-mint-v1.raydium.iolaunch-mint-v1-devnet.raydium.ioTìm kiếm token, chỉ mục, bảng xếp hạng, siêu dữ liệu cho mỗi mint cho các bản phát hành LaunchLab.
LaunchLab History APIlaunch-history-v1.raydium.iolaunch-history-v1-devnet.raydium.ioLịch sử giao dịch, tập hợp K-line cho các pool LaunchLab.
LaunchLab Forum APIlaunch-forum-v1.raydium.iolaunch-forum-v1-devnet.raydium.ioBình luận, luồng, tải lên IPFS liên kết đến một bản phát hành LaunchLab. Có chữ ký ví.
LaunchLab Auth APIlaunch-auth-v1.raydium.iolaunch-auth-v1-devnet.raydium.ioPhát hành các JWT ray-token có thời hạn ngắn từ một thông báo được ký ví. Bắt buộc để gọi forum API.
Dynamic IPFS APIdynamic-ipfs.raydium.iodynamic-ipfs-devnet.raydium.ioTrình tái tạo hình ảnh / siêu dữ liệu NFT. Điều khiển nghệ thuật vị trí CLMM và các NFT on-chain khác có giao diện phụ thuộc vào trạng thái động.
Owner APIowner-v1.raydium.ioowner-v1-devnet.raydium.ioVị trí, số dư, phần thưởng có thể yêu cầu cho mỗi ví.
API v1api.raydium.io—Endpoint v1/v2 cũ, được giữ hoạt động cho các máy khách chưa di chuyển sang API v3.
Temp APItemp-api-v1.raydium.iotemp-api-v1-devnet.raydium.ioKho chứa các endpoint tùy chỉnh có thời hạn ngắn. Hiện tại hiển thị tóm tắt phí tạo CPMM. Có thể thay đổi mà không cần thông báo.

​
Xác thực

Hầu hết các dịch vụ chỉ dành để đọc và chấp nhận các yêu cầu ẩn danh. Hai mẫu xuất hiện:
  • Bắt tay được ký bằng ví — yêu cầu bởi launch-auth-v1 để tạo mint ray-token, sau đó được thực hiện dưới dạng header ray-token bởi launch-forum-v1. Ký một thông báo Solana ed25519 có dạng time:<unix-seconds> bằng ví của bạn, gửi chữ ký + địa chỉ ví đến /request-token của launch-auth-v1, nhận JWT trở lại và chuyển nó dưới dạng header yêu cầu ray-token trên các cuộc gọi diễn đàn tiếp theo.
  • Không có xác thực — mọi dịch vụ khác. Những người gọi đáng tin cậy (giao diện Raydium, nhà tích hợp) truy cập các endpoint trực tiếp qua HTTPS.
Sân chơi Mintlify cho phép bạn dán một ray-token trong bảng điều khiển xác thực trước khi gửi các yêu cầu diễn đàn; giá trị được giữ chỉ trong trình duyệt của bạn.

​
Giới hạn tốc độ

Tất cả các máy chủ đều nằm sau Cloudflare với giới hạn tốc độ theo tiến độ cho mỗi IP nguồn. Các nhà tích hợp cần giới hạn cao hơn nên liên hệ với nhóm Raydium. Các loạt vượt quá các giới hạn được công bố được trả về dưới dạng HTTP 429 với header Retry-After.

​
Bao bọc phản hồi

Hầu hết các dịch vụ bao bọc các trọng tải JSON của chúng trong một bao bọc thống nhất: 
{
  "id": "uuid-v4-per-request",
  "success": true,
  "data": { ... }
}
Khi thất bại: 
{
  "id": "uuid-v4-per-request",
  "success": false,
  "msg": "human-readable error string",
  "data": null
}
api-v3 trả về bao bọc dưới dạng { "id", "success", "data" }. Các dịch vụ pump-* sử dụng các trợ giúp addBorderSuccess / addBorderErr tạo ra cùng một hình dạng với msg chỉ được điền vào khi có lỗi. Kiểm tra trang giới thiệu của từng dịch vụ để biết bao bọc chính xác mà nó sử dụng.

​
Cách sử dụng phần này

Nhấp vào bất kỳ endpoint nào trong điều hướng bên trái. Bạn sẽ thấy:
  • Phương thức HTTP, URL đầy đủ và máy chủ cơ sở.
  • Tham số yêu cầu với các loại được lấy từ thông số kỹ thuật OpenAPI.
  • Panel Thử nó cho phép bạn đặt tham số và gửi yêu cầu thực tế đến mainnet (hoặc chọn máy chủ devnet từ trình đơn thả xuống khi có sẵn).
  • Hình dạng phản hồi, được lấy từ phản hồi trực tiếp đại diện và vị trí gọi addBorderSuccess của mã nguồn.
Để truy cập cấp độ SDK — xây dựng giao dịch phía máy khách, tổng hợp swap, các loại TypeScript — xem sdk-api/typescript-sdk.

​
Con trỏ

  • sdk-api/rest-api — tổng quan về câu chuyện của bề mặt REST, được viết cho những người tích hợp lần đầu.
  • integration-guides/aggregator — cách sử dụng Transaction API cùng với các pool on-chain.
  • reference/program-addresses — mọi ID chương trình được trả về bởi api-v3 giải quyết thành một trong những chương trình này.