---
title: "One page of an exchange's addresses on one network"
method: GET
path: "/v1/entities/{slug}/addresses"
tags: ["entities"]
---

# One page of an exchange's addresses on one network

`GET /v1/entities/{slug}/addresses`

## Request

- Base URL: `https://stablescan.achivx.com`
- URL: `https://stablescan.achivx.com/v1/entities/{slug}/addresses`
- Auth: none required

The exchange's own wallets (`group=own`, by balance then turnover) or its customers' deposit addresses (`group=deposit`, by 30d turnover) on one network, 100 to a page in the order the nightly build fixed: page n is the same rows for every reader until the next build (`built_at`). `total` and `pages` size the list. Every other query parameter is refused.

## Path parameters

- `slug` string, required

## Query parameters

- `chain` string, required
- `group` 'own' | 'deposit'
- `page` integer
- `limit` integer

## Response `200`

One page of an exchange's addresses on one network.

- EntityAddresses
  - `built_at` string, required: The build the order belongs to: page n is the same rows until the next build.
  - `chain_id` integer, required
  - `group` string, required: own or deposit.
  - `items` object[], nullable, required
    - `address` string, required
    - `balance_usd6` integer, nullable, required: Live stablecoin balance; null when not read (deposit addresses are not read, and a failed read is not a zero).
    - `balances` object[], nullable, required: balance_usd6 by stablecoin, largest first; null when not read.
      - `symbol` string, required
      - `usd6` integer, required
    - `chain_id` integer, required
    - `derived` boolean, required: True when the scanner derived the address from on-chain sweeps rather than reading it from the exchange's own list.
    - `frozen` boolean, required
    - `group` string, required: own (the exchange's wallets) or deposit (its customers' deposit addresses).
    - `in_30d_usd6` integer, required: Everything the address received in the 30d window, internal transfers included.
    - `last_active_day` string: Newest UTC day with a stablecoin transfer since the pass started measuring; empty when none.
    - `network` string, required
    - `out_30d_usd6` integer, required: Everything the address sent in the 30d window, internal transfers included (a deposit's sweep is its outflow).
    - `rank` integer, required: Position within (network, group): own by balance then turnover, deposits by 30d turnover.
    - `role` string, required: listed, hot or cold (the exchange's own list), collector or deposit (derived by the label graph).
    - `sanctioned` boolean, required
    - `tx_30d` integer, required
  - `limit` integer, required
  - `network` string, required
  - `page` integer, required
  - `pages` integer, required
  - `slug` string, required
  - `total` integer, required: Addresses in this (network, group) list.

## Other responses

- `400`: The one error envelope. Branch on `error.code`, not on the status.
- `404`: The one error envelope. Branch on `error.code`, not on the status.
- `429`: The per-IP token bucket (20 requests/second, burst 40) is empty — wait `Retry-After`.
- `500`: The one error envelope. Branch on `error.code`, not on the status.
- `503`: The one error envelope. Branch on `error.code`, not on the status.

---

[API](https://skmtc.dev/achivx/apis/stablecoin-scanner-rest-api.md) · [All operations](https://skmtc.dev/achivx/apis/stablecoin-scanner-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/achivx/apis/stablecoin-scanner-rest-api/revisions/cbd001c8925c?raw)