메인 콘텐츠로 건너뛰기

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 자동 번역입니다. 모든 내용은 영문판을 기준으로 합니다.영문판 보기 →

​
Raydium API v3란 무엇인가요?

Raydium API v3는 Solana의 Raydium 거래소에서 유동성 풀, 토큰 메타데이터, 팜, 체인 통계를 조회할 수 있는 REST 인터페이스를 제공합니다. 지갑, 애그리게이터, DEX 라우터, 거래자들이 정식 풀 데이터, 가격 피드, 과거 분석을 조회하는 데 사용합니다. 이 API는 높은 처리량을 위해 설계되었습니다. 응답은 일반적으로 엔드포인트의 민감도에 따라 1~5분의 지연이 있습니다. 모든 응답은 메타데이터와 함께 일관된 형식의 봉투로 감싸져 있습니다.

​
베이스 호스트

환경URL
메인넷https://api-v3.raydium.io
데브넷https://api-v3-devnet.raydium.io

​
응답 형식

모든 엔드포인트는 요청 메타데이터와 응답 페이로드를 포함하는 JSON 봉투를 반환합니다:

​
성공 응답

{
  "id": "abc123def456",
  "success": true,
  "data": {
    // Endpoint-specific data
  }
}

​
오류 응답

{
  "id": "abc123def456",
  "success": false,
  "msg": "query ids type error"
}
id 필드는 고유한 요청 식별자(UUID)입니다. data를 처리하기 전에 항상 success를 확인해야 합니다.

​
자주 발생하는 문제

​
/pools/info/mint에서의 민트 쌍 정렬

/pools/info/mint?mint1=ABC&mint2=XYZ로 쿼리할 때, 엔드포인트는 내부적으로 민트를 알파벳 순서로 정렬하여 쌍을 정규화합니다. 단일 민트를 검색해야 하는 경우 mint2를 완전히 생략하면 API가 해당 민트를 포함하는 모든 풀을 찾습니다.

​
풀 유형 필터 값

poolType 쿼리 매개변수는 다음의 특정 열거형 값을 받습니다:
  • all — 모든 풀 유형
  • concentrated — CLMM 풀만
  • standard — AMM(상수곱) 풀만
  • allFarm — 활성 팜이 최소 1개 이상인 풀
  • concentratedFarm — 팜이 있는 농축 풀
  • standardFarm — 팜이 있는 표준 풀
오타나 대소문자 불일치가 있으면 요청이 거부됩니다.

​
풀 정렬 필드 값

유효한 poolSortField 값은 다음과 같습니다:
  • default (24시간 거래량으로 정렬)
  • liquidity (TVL)
  • volume24h, volume7d, volume30d
  • fee24h, fee7d, fee30d
  • apr24h, apr7d, apr30d

​
/pools/info/list-v2를 사용한 페이지 매김

v2 엔드포인트는 nextPageId를 통해 커서 기반 페이지 매김을 사용합니다. 불투명한 토큰은 응답에서 반환되며 그대로 다시 전달해야 합니다. 직접 커서를 구성하려고 시도하지 마세요. 이것은 Elasticsearch 상태를 인코딩합니다.

​
페이지 크기 기본값 및 한계

  • /pools/info/list와 /pools/info/mint는 pageSize를 1000으로 제한합니다.
  • /farms/info/lp는 pageSize를 100으로 제한합니다.
  • /pools/info/list-v2는 size를 1000으로 제한합니다.
한계를 초과하는 요청은 오류와 함께 거부됩니다.

​
CLMM 동적 수수료 및 지정가 주문 설정

두 가지 새로운 엔드포인트는 CLMM CreateCustomizablePool 흐름을 위한 보정 데이터를 제공합니다:
  • GET /main/clmm-dynamic-config — DynamicFeeConfig 계층 목록(필터 기간, 감쇠 기간, 감소 계수, 최대 분자, 동적 수수료 제어). enableDynamicFee=true일 때 이 중 하나의 id를 createCustomizablePool에 전달합니다.
  • GET /main/clmm-limit-order-config — 풀별 지정가 주문 설정: 지정가 주문 활성화 여부, 최소 입력 금액, 채워진 주문을 정산하도록 승인된 오프체인 limit_order_admin 키퍼입니다.
지갑별 지정가 주문 데이터(미체결/체결/종료)는 Temp API에 있습니다. api-reference/temp-api-v1/overview를 참조하세요.

​
관련 문서

​
사용 예시

메인 통계 가져오기: 
curl -s https://api-v3.raydium.io/main/info | jq .
TVL 기준 상위 10개 풀 나열: 
curl -s 'https://api-v3.raydium.io/pools/info/list?poolType=all&poolSortField=liquidity&sortType=desc&pageSize=10&page=1' | jq .
SOL-USDC 풀 가져오기: 
curl -s 'https://api-v3.raydium.io/pools/info/mint?mint1=So11111111111111111111111111111111111111112&mint2=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&poolType=all&poolSortField=liquidity&sortType=desc&pageSize=5&page=1' | jq .
민트 가격 가져오기: 
curl -s 'https://api-v3.raydium.io/mint/price?mints=So11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v,4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R' | jq .
LP 토큰을 위한 팜 풀 가져오기: 
curl -s 'https://api-v3.raydium.io/farms/info/lp?lp=<lp_mint>&pageSize=10&page=1' | jq .

​
상태 및 가용성

Raydium API v3는 메인넷에서 운영 중입니다. 가용성 및 장애 현황은 @Raydium을 팔로우하세요.