# 거래소 전체를 어떻게 읽습니까: 주소, 흐름, 잔액

레지스트리, 검색, 시장 데이터 · 라벨 목록(label book)으로 하루 한 번 만들어지는 공개 거래소: 주소 수, 네 가지 기간의 주소 집합 경계를 넘는 흐름, 자체 지갑의 실시간 잔액, 90일 시계열

*API 가이드 · 8분 · 중급 · 개발자 · GET /v1/entities · /{slug} · /addresses · /daily*

`GET /v1/entities`는 공개된 거래소를 30일 흐름이 큰 순서로 나열하며, 각각 `addresses` 수, `flows_30d`, `balances`, `frozen`, `sanctioned`가 있습니다. `GET /v1/entities/{slug}`는 거래소 하나입니다. 네 가지 기간(24h, 7d, 30d, 90d)의 흐름을 네트워크별·스테이블코인별로, 주소 목록의 앞부분, 그리고 거래한 다른 거래소들을 담고 있습니다. `/addresses?chain=&group=own|deposit`은 주소 집합을 한 페이지에 100개씩, 야간 빌드가 정한 순서로 페이지를 나눕니다. `/daily`는 90일 시계열입니다. 유입은 집합으로 들어오는 것, 유출은 집합에서 나가는 것이며, 핫월렛으로 모아진 입금은 `internal`입니다. 고객 입금은 한 번만 셉니다.

## 목록

```
curl -s https://stablescan.achivx.com/v1/entities
```

2026-10-24 기준 거래소 아홉 곳이며, 바이낸스(Binance)가 첫 번째입니다.

```
{
  "items": [
    {"slug": "binance", "name": "Binance", "page": "/entity/binance", "built_at": "2026-10-24T08:00:31Z", "as_of_day": "2026-10-23", "indexable": true, "networks": 6,
     "addresses": {"total": 469121, "own": 141, "collectors": 26, "deposits": 468954, "active_30d": 469034},
     "flows_30d": {"window": "30d", "from": "2026-09-24", "to": "2026-10-23", "window_days": 30, "days_measured": 28, "complete": false,
                   "inflow_usd6": 65880775439960649, "inflow_via_deposits_usd6": 39928913776359449, "outflow_usd6": 67563907571256715, "netflow_usd6": -1683132131296066,
                   "internal_usd6": 89855081266499385, "swept_usd6": 42021931009195830, "transfers": 20601579},
     "balances": {"total_usd6": 38387341559604479, "read": 167, "total": 167, "read_at": "2026-10-24T07:59:56Z"},
     "frozen": 0, "sanctioned": 0},
    {"slug": "okx", "name": "OKX", "…": "…"},
    "… +7 more"
  ],
  "note": "One exchange as a whole: every address the label book gives it on our settled networks — the wallets its own Proof-of-Reserves list names, and the deposit addresses and collectors the scanner derived from on-chain sweeps (derived: true) — and its stablecoin flows across the boundary of that set …"
}
```

30일 중 측정된 28일 동안 바이낸스의 주소 469,121개로 659억 달러가 들어오고 676억 달러가 나갔으며(`complete: false`: 이틀은 아직 모든 네트워크에서 측정되지 않았습니다), 07:59 UTC 기준 자체 지갑 167개에 384억 달러의 스테이블코인이 있었습니다.

## 거래소 하나

```
curl -s https://stablescan.achivx.com/v1/entities/binance
```

같은 헤더 다음에 네 가지 기간의 `flows[]`가 오고, `networks[]`에는 네트워크별 자체 수치, 네 가지 기간, `prev_balance_usd6`와 비교한 `balance_usd6`, `measured_from`(흐름 측정이 시작된 첫날 — 이더리움(Ethereum)에서는 `2026-09-26`), `last_indexed_block`이 있습니다. 이어서 스테이블코인별 분할, 주소 목록의 앞부분, 그리고 스테이블코인을 주고받은 다른 거래소들이 옵니다. `last_active_day`, `labels_updated`, `list_carries_deposits`는 빌드를 설명합니다. 공개되지 않은 슬러그는 `404 not_found` — *no published entity “x” — GET /v1/entities lists them* — 입니다.

## 주소 목록

```
curl -s 'https://stablescan.achivx.com/v1/entities/binance/addresses?chain=1&group=own&limit=5'
```

```
{
  "slug": "binance", "chain_id": 1, "network": "ethereum", "group": "own", "page": 1, "limit": 5, "total": 44, "pages": 9,
  "items": [
    {"address": "0xf977814e90da44bfa03b6295a0616a897441acec", "group": "own", "rank": 1, "role": "listed", "derived": false,
     "in_30d_usd6": 119871208290208, "out_30d_usd6": 183979569971000, "tx_30d": 12, "last_active_day": "2026-10-15",
     "balance_usd6": 16421126616225708, "balances": [{"symbol": "USDT", "usd6": 16000000001136208}, {"symbol": "USDe", "usd6": 210778608611000}, "…"],
     "frozen": false, "sanctioned": false},
    "… +4 more"
  ],
  "built_at": "2026-10-24T08:00:31Z"
}
```

여기서는 `chain`이 필수입니다(목록이 네트워크별이기 때문입니다). `group`은 `own`(거래소의 지갑, 잔액 다음 회전액 순 — 준비금 증명(Proof-of-Reserves) 목록에서 온 `role: "listed"`, `derived: false`) 또는 `deposit`(고객 입금 주소, 30일 회전액 순, `derived: true`, 잔액을 읽지 않음: `balance_usd6: null`)입니다. 바이낸스의 트론(Tron) 입금 주소는 190,453개, 3개씩 63,485페이지에 달했습니다. 그 밖의 매개변수는 `page`와 `limit`(1–100)뿐이며, 다른 매개변수는 모두 거부됩니다. 페이지 *n*은 다음 빌드 전까지 모든 독자에게 같은 행입니다.

## 일별 시계열

```
curl -s https://stablescan.achivx.com/v1/entities/binance/daily
```

90일 기간 중 측정된 UTC 날짜마다 행이 하나이며, 오래된 것부터 나옵니다. 모든 네트워크에 걸친 `inflow_usd6`, `outflow_usd6`, `internal_usd6`, `swept_usd6`와 `networks[]` 분할이 있습니다. 어느 네트워크에서도 아직 측정되지 않은 날은 행이 없습니다. 2026-10-24 기준 28행입니다.

[첫 요청](https://achivx.kr/academy/api/first-request/)의 세 가지 헬퍼로 같은 호출을 하면 다음과 같습니다.

**Python**

```
ex = scan("/v1/entities/binance")
for f in ex["flows"]:
    net = f["netflow_usd6"] / 1e6
    print(f'{f["window"]:>3}: in ${f["inflow_usd6"]/1e9:,.1f}B out ${f["outflow_usd6"]/1e9:,.1f}B net {net:+,.0f}',
          "" if f["complete"] else f'(only {f["days_measured"]} of {f["window_days"]} days measured)')
daily = scan("/v1/entities/binance/daily")["daily"]
print("series:", daily[0]["day"], "to", daily[-1]["day"], len(daily), "days")
```

**Go**

```
var ex struct {
	Name  string `json:"name"`
	Flows []struct {
		Window       string `json:"window"`
		Complete     bool   `json:"complete"`
		DaysMeasured int    `json:"days_measured"`
		WindowDays   int    `json:"window_days"`
		InflowUSD6   int64  `json:"inflow_usd6"`
		OutflowUSD6  int64  `json:"outflow_usd6"`
		NetflowUSD6  int64  `json:"netflow_usd6"`
	} `json:"flows"`
}
if err := get("/v1/entities/binance", nil, &ex); err != nil {
	return err
}
```

**TypeScript**

```
type Flow = { window: "24h" | "7d" | "30d" | "90d"; from: string; to: string; window_days: number; days_measured: number; complete: boolean; inflow_usd6: number; inflow_via_deposits_usd6: number; outflow_usd6: number; netflow_usd6: number; internal_usd6: number; swept_usd6: number; transfers: number };
type Entity = { slug: string; name: string; as_of_day: string; built_at: string; addresses: { total: number; own: number; collectors: number; deposits: number; active_30d: number }; flows: Flow[] };
const ex = await scan<Entity>("/v1/entities/binance");
```

## 필드별 설명

**`inflow_usd6`, `outflow_usd6`, `netflow_usd6`** — 주소 집합의 경계를 넘는 흐름입니다. 외부에서 거래소의 어느 주소로든 들어오는 전송은 유입, 어느 주소에서든 나가는 전송은 유출입니다. **`internal_usd6`** — 양 끝이 모두 집합 안에 있는 흐름(핫월렛으로 모아진 입금)으로, 고객 입금이 이중으로 계산되지 않도록 따로 셉니다. **`swept_usd6`**는 그중 스윕에 해당하는 부분이고, **`inflow_via_deposits_usd6`**는 파생된 입금 주소를 통해 들어온 유입입니다. **`complete`**와 함께 오는 **`window_days` 중 `days_measured`** — 기간의 날짜는 네트워크별로 측정되며, 가장 최근 하루나 이틀이 빠질 수 있습니다. **`balances`** — *자체* 지갑만 실시간으로 읽은 것입니다. 거래소의 온체인 스테이블코인의 하한이지 준비금이 아닙니다(`total`개 지갑 중 `read`개, `read_at`).

마감된 UTC 날짜(`as_of_day`)로 하루 한 번 만들어지며, `max-age=600`입니다. 출처는 [라벨 목록(label book)](https://achivx.kr/academy/concepts/labels-and-attribution/)이며, `derived: true`는 거래소가 공개한 것이 아니라 스캐너가 스윕에서 추론한 것을 표시합니다.

## Stablecoin scanner ACHIVX에서

- 목록과 거래소 하나: [/v1/entities](https://stablescan.achivx.com/v1/entities), [/v1/entities/binance](https://stablescan.achivx.com/v1/entities/binance); 이더리움의 자체 지갑: [/addresses?chain=1&group=own](https://stablescan.achivx.com/v1/entities/binance/addresses?chain=1&group=own&limit=10).
- 같은 거래소의 페이지: [/entity/binance](https://stablescan.achivx.com/entity/binance), 그리고 허브 [/entities](https://stablescan.achivx.com/entities).

## 출처

- [REST 인터페이스의 OpenAPI 3.1 명세(API 1.4.0)](https://stablescan.achivx.com/openapi.json)
- [GET /v1/entities (2026-10-24 조회)](https://stablescan.achivx.com/v1/entities)
- [GET /v1/entities/binance/addresses?chain=1&group=own&limit=5 (2026-10-24 조회)](https://stablescan.achivx.com/v1/entities/binance/addresses?chain=1&group=own&limit=5)

## 더 알아보기

- [라벨과 귀속](https://achivx.kr/academy/concepts/labels-and-attribution/)
- [가이드: 주소 페이지](https://achivx.kr/academy/guides/address-page/)

## 관련 질문

- [레시피: 거래소의 일별 스테이블코인 흐름 추적하기](https://achivx.kr/academy/api/recipe-watch-an-exchange/)
- [스테이블코인 하나의 최대 보유 주소와 가장 활발한 경로는 어떻게 가져옵니까?](https://achivx.kr/academy/api/token-rankings/)
- [사이트 검색창처럼 이름이나 심볼로 검색하려면 어떻게 합니까?](https://achivx.kr/academy/api/search/)

레지스트리, 검색, 시장 데이터 · GET /v1/entities · /{slug} · /addresses · /daily · 2026-10-24 작성, openapi.json, agents.md 및 당일 실제 호출 기준. 응답 형태는 인용이며, 수치는 날짜 기준이고 인덱스에 따라 달라집니다.

---

출처: https://achivx.kr/academy/api/exchanges/ · 영어 원문: https://achivx.com/academy/api/exchanges.html