메인 콘텐츠로 건너뛰기

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.

이 페이지는 AI 자동 번역입니다. 모든 내용은 영문판을 기준으로 합니다.영문판 보기 →
이 사이트의 모든 엔드포인트는 Mintlify의 OpenAPI 플레이그라운드로 구동하는 Try it 패널을 갖추고 있습니다. 플레이그라운드는 브라우저에서 실행되며 라이브 프로덕션(또는 데브넷) 호스트에 직접 요청을 보냅니다. 지갑 서명이 필요한 요청을 보내기 전에 인증 섹션을 읽어보세요.

​
서비스 카탈로그

Raydium은 11개의 공개 HTTP 서비스를 운영합니다. 각각은 왼쪽 네비게이션 트리에서 자신의 그룹으로 문서화되어 있습니다.
서비스메인넷 호스트데브넷 호스트기능
API v3api-v3.raydium.ioapi-v3-devnet.raydium.io풀 / 민트 / 설정 / 체인 정보 — UI와 SDK가 의존하는 정규 읽기 API입니다.
Transaction APItransaction-v1.raydium.iotransaction-v1-devnet.raydium.io서버 측 스왑 / 유동성 트랜잭션 구성. 애그리게이터 진입점입니다.
Perps APIapi-perp-v1.raydium.io—Raydium Perps 프론트엔드용 설정, 자산 메타데이터, RPC 선택.
LaunchLab Mint APIlaunch-mint-v1.raydium.iolaunch-mint-v1-devnet.raydium.io토큰 검색, 인덱스, 리더보드, LaunchLab 런치별 민트 메타데이터.
LaunchLab History APIlaunch-history-v1.raydium.iolaunch-history-v1-devnet.raydium.ioLaunchLab 풀의 거래 히스토리, K선 집계.
LaunchLab Forum APIlaunch-forum-v1.raydium.iolaunch-forum-v1-devnet.raydium.ioLaunchLab 런치와 연결된 댓글, 스레드, IPFS 업로드. 지갑 서명 필요.
LaunchLab Auth APIlaunch-auth-v1.raydium.iolaunch-auth-v1-devnet.raydium.io지갑 서명 메시지에서 단기 ray-token JWT를 발급합니다. 포럼 API 호출 시 필수.
Dynamic IPFS APIdynamic-ipfs.raydium.iodynamic-ipfs-devnet.raydium.ioNFT 이미지 / 메타데이터 재생성기. CLMM 포지션 아트 및 동적 상태에 따라 외형이 달라지는 온체인 NFT를 구동합니다.
Owner APIowner-v1.raydium.ioowner-v1-devnet.raydium.io지갑별 포지션, 잔액, 청구 가능한 보상.
API v1api.raydium.io—레거시 v1/v2 엔드포인트, API v3로 마이그레이션하지 않은 클라이언트를 위해 유지됨.
Temp APItemp-api-v1.raydium.iotemp-api-v1-devnet.raydium.io단기 맞춤형 엔드포인트용 임시 저장소. 현재 CPMM 크리에이터 수수료 요약을 노출합니다. 예고 없이 변경될 수 있습니다.

​
인증

대부분의 서비스는 읽기 전용이며 익명 요청을 수용합니다. 두 가지 패턴이 나타납니다:
  • 지갑 서명 핸드셰이크 — launch-auth-v1이 ray-token을 발급하고 launch-forum-v1에서 ray-token 헤더로 전달하기 위해 필요합니다. time:<unix-seconds> 형식의 Solana ed25519 메시지를 지갑으로 서명하고, 서명 + 지갑 주소를 launch-auth-v1 /request-token으로 보낸 다음 JWT를 받아 후속 포럼 호출의 ray-token 요청 헤더로 전달합니다.
  • 인증 없음 — 다른 모든 서비스. 신뢰하는 호출자(Raydium UI, 통합자)는 HTTPS를 통해 엔드포인트에 직접 접근합니다.
Mintlify 플레이그라운드를 사용하면 포럼 요청을 보내기 전에 인증 패널에 ray-token을 붙여넣을 수 있으며, 이 값은 브라우저에만 유지됩니다.

​
요청 한도

모든 호스트는 소스 IP별 점진적 요청 제한이 있는 Cloudflare 뒤에 있습니다. 더 높은 한도가 필요한 통합자는 Raydium 팀에 문의해야 합니다. 공개된 한도를 초과하는 버스트는 Retry-After 헤더와 함께 HTTP 429로 반환됩니다.

​
응답 엔벨로프

대부분의 서비스는 JSON 페이로드를 통일된 엔벨로프로 감싸습니다: 
{
  "id": "uuid-v4-per-request",
  "success": true,
  "data": { ... }
}
실패 시: 
{
  "id": "uuid-v4-per-request",
  "success": false,
  "msg": "human-readable error string",
  "data": null
}
api-v3는 엔벨로프를 { "id", "success", "data" }로 반환합니다. pump-* 서비스는 addBorderSuccess / addBorderErr 헬퍼를 사용하여 동일한 형태를 생성하되 msg는 오류 시에만 채워집니다. 각 서비스의 소개 페이지에서 사용하는 정확한 엔벨로프를 확인하세요.

​
이 섹션 사용 방법

왼쪽 네비게이션에서 아무 엔드포인트나 클릭하세요. 다음을 보게 됩니다:
  • HTTP 메서드, 전체 URL, 기본 호스트.
  • OpenAPI 스펙에서 가져온 타입의 요청 파라미터.
  • 파라미터를 설정하고 메인넷(또는 가능한 경우 드롭다운에서 데브넷 서버를 선택)에 실제 요청을 보낼 수 있는 Try it 패널.
  • 대표 라이브 응답과 소스 코드의 addBorderSuccess 호출 사이트에서 가져온 응답 형태.
SDK 레벨 액세스의 경우 — 클라이언트 측 트랜잭션 구성, 스왑 일괄 처리, TypeScript 타입 — sdk-api/typescript-sdk를 참고하세요.

​
관련 링크