> ## 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.

# Raydium API v3

> Solana의 Raydium 풀, 민트, 팜, 체인 데이터를 조회하는 REST API

<Info>
  **이 페이지는 AI 자동 번역입니다. 모든 내용은 영문판을 기준으로 합니다.**

  [영문판 보기 →](/api-reference/api-v3/overview)
</Info>

## 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 봉투를 반환합니다:

### 성공 응답

```json theme={null}
{
  "id": "abc123def456",
  "success": true,
  "data": {
    // Endpoint-specific data
  }
}
```

### 오류 응답

```json theme={null}
{
  "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`](/ko/api-reference/temp-api-v1/overview)를 참조하세요.

## 관련 문서

* [REST API 개요](/ko/sdk-api/rest-api)
* [API 참조](/ko/api-reference)
* [애그리게이터 통합 가이드](/ko/integration-guides/aggregator)

## 사용 예시

**메인 통계 가져오기:**

```bash theme={null}
curl -s https://api-v3.raydium.io/main/info | jq .
```

**TVL 기준 상위 10개 풀 나열:**

```bash theme={null}
curl -s 'https://api-v3.raydium.io/pools/info/list?poolType=all&poolSortField=liquidity&sortType=desc&pageSize=10&page=1' | jq .
```

**SOL-USDC 풀 가져오기:**

```bash theme={null}
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 .
```

**민트 가격 가져오기:**

```bash theme={null}
curl -s 'https://api-v3.raydium.io/mint/price?mints=So11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v,4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R' | jq .
```

**LP 토큰을 위한 팜 풀 가져오기:**

```bash theme={null}
curl -s 'https://api-v3.raydium.io/farms/info/lp?lp=<lp_mint>&pageSize=10&page=1' | jq .
```

## 상태 및 가용성

Raydium API v3는 메인넷에서 운영 중입니다. 가용성 및 장애 현황은 [@Raydium](https://x.com/Raydium)을 팔로우하세요.