> For the complete documentation index, see [llms.txt](https://docs.nexus.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nexus.xyz/exchange/ko/overview/exchange-testnet.md).

# 거래소 테스트넷

테스트넷 거래소에서 거래하기: 인증하고, 키를 발급하고, 합성 USDX를 받고, 주문을 제출합니다.

Nexus Exchange는 [nexus.xyz/trade](https://nexus.xyz/trade)에서 테스트넷으로 가동 중입니다.

API를 통해 인증하고, 주문을 제출하고, 가동 중인 무기한 선물 시장에서 거래할 수 있습니다.

프런트엔드는 실시간 거래소 상태를 읽기 전용으로 보여 줍니다. 모든 거래는 REST 및 WebSocket API를 통해 이루어집니다.

전체 API 문서는 이 문서의 [API 레퍼런스](https://docs.nexus.xyz/api-reference) 섹션에 있습니다.

### 시작하기

#### 1. 인증

Ethereum 지갑으로 EIP-191 개인 서명을 해서 로그인합니다.

```bash
POST /auth/login
```

`"Sign in to Nexus Exchange"` 메시지에 서명하면 세션 토큰(TTL 24시간)을 받습니다. 처음 로그인하면 계정이 생성됩니다.

#### 2. API 키 생성

```bash
POST /keys
```

이 호출은 HMAC 키 쌍(`key_id` + `secret`)을 반환합니다. 시크릿은 한 번만 표시되므로 즉시 저장하십시오.

키는 `GET /keys`(목록 조회)와 `DELETE /keys/{key_id}`(폐기)로 관리합니다.

#### 3. 계정에 자금 넣기

포셋에서 합성 USDX를 받아 테스트넷 계정에 충전합니다.

```bash
POST /account/credit
```

주문을 제출하려면 USDX 잔액이 있어야 합니다. 잔액은 언제든지 `GET /account`로 확인할 수 있습니다.

**각 API 키는 하루에 최대 500 테스트 USDX를 받을 수 있습니다.**

#### 4. 주문 제출

모든 거래 요청은 `X-API-Key`, `X-Timestamp`, `X-Signature` 세 개의 헤더로 인증합니다.

```bash
POST /orders
```

```json
{
  "market_id": "BTC-USDX-PERP",
  "side": "Buy",
  "order_type": "Limit",
  "price": "67000",
  "quantity": "0.01",
  "time_in_force": "GTC"
}
```

전체 인증 예시와 사용 가능한 모든 엔드포인트는 [API 레퍼런스](https://docs.nexus.xyz/api-reference) 섹션을 참조하십시오.

### 시장

USDX로 표시되는 세 개의 암호화폐 무기한 선물이 가동 중입니다.

| 시장              | 기초 자산   |
| --------------- | ------- |
| `BTC-USDX-PERP` | Bitcoin |
| `ETH-USDX-PERP` | Ether   |
| `SOL-USDX-PERP` | Solana  |

시장은 상장과 상장폐지에 따라 달라집니다. 현재 가동 중인 시장은 `GET /markets`로, 통계를 포함한 목록은 `GET /markets/summary`로 조회하십시오. 이후 추가될 자산군은 [자산 목록](/exchange/ko/asset-directory/asset-directory.md)을 참조하십시오.

### 거래소 텔레메트리

거래소 전체의 집계 텔레메트리는 API로 제공됩니다. 이 엔드포인트는 **공개**되어 있으며 API 키가 필요하지 않습니다.

| 엔드포인트                             | 반환 내용                     |
| --------------------------------- | ------------------------- |
| `GET /stats`                      | 롤링 고유 트레이더 수를 포함한 거래소 스냅샷 |
| `GET /stats/history`              | 시간에 따른 처리량 샘플             |
| `GET /stats/volume`               | 누적 거래 명목 가치(거래소 전체 및 시장별) |
| `GET /stats/open-interest`        | 롱과 숏을 따로 보고하는 미결제약정       |
| `GET /stats/balance-distribution` | 잔액 구간별 계정 수               |

이 엔드포인트들은 모두 **구조상 계정별 데이터를 포함하지 않는다**고 문서화되어 있으며, 그래서 공개되어 있습니다. 응답 형태와 부호 및 단위 관련 주의 사항은 [거래소 통계](https://docs.nexus.xyz/api-reference/guides/statistics)를 참조하십시오. 특히 미결제약정은 양쪽을 따로 보고하며, `gross_oi_two_sided_quote`는 한쪽 수치의 두 배입니다.

현재 프로덕션 프런트엔드에는 공개 분석 대시보드가 없습니다. 위의 엔드포인트를 사용하십시오.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.nexus.xyz/exchange/ko/overview/exchange-testnet.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.