---
title: "Exchanges as a whole"
method: GET
path: "/v1/entities"
tags: ["entities"]
---

# Exchanges as a whole

`GET /v1/entities`

## Request

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

The published exchanges, largest 30d inflow plus outflow first, each with its address counts, its 30d flows across the boundary of its address set, its own wallets' live balances and its frozen and sanctioned addresses. Built once a day from closed UTC days (`as_of_day`); every window says how many of its days are measured.

## Response `200`

The published exchanges.

- Entities
  - `items` object[], nullable, required: Published entities, largest 30d inflow plus outflow first.
    - `addresses` object, required
      - `active_30d` integer, required: Addresses with at least one stablecoin transfer in the 30d window.
      - `collectors` integer, required: Derived collector wallets: addresses the entity's deposits sweep into and that forward to its reserves.
      - `deposits` integer, required: Derived deposit addresses: customer addresses at the exchange whose outflow sweeps (at least 95 percent) into it.
      - `own` integer, required: Addresses from the exchange's own Proof-of-Reserves list (listed, hot, cold).
      - `total` integer, required: Every address of the entity on the settled networks.
    - `as_of_day` string, required
    - `balances` object, required
      - `read` integer, required
      - `read_at` string, required
      - `total` integer, required
      - `total_usd6` integer, nullable, required: Live stablecoin balance of the entity's own wallets that were read; null when none was.
    - `built_at` string, required
    - `flows_30d` object, required
      - `complete` boolean, required: True when every day of the window is measured.
      - `days_measured` integer, required: Days of the window measured on every network in scope. The sums include every day measured on any network, so a window short of a day on one network is not complete.
      - `from` string, required: First UTC day of the window.
      - `inflow_usd6` integer, required: Transfers from outside the entity's address set into it.
      - `inflow_via_deposits_usd6` integer, required: The part of inflow that landed on a deposit address.
      - `internal_usd6` integer, required: Transfers with both ends in the entity's address set; in neither inflow nor outflow.
      - `netflow_usd6` integer, required: inflow minus outflow.
      - `outflow_usd6` integer, required: Transfers from the entity's address set to outside it.
      - `swept_usd6` integer, required: The part of internal paid by a deposit address: customer deposits collected into the exchange's wallets.
      - `to` string, required: Last UTC day of the window (as_of_day).
      - `transfers` integer, required: Transfers across the boundary (inflow plus outflow), counted per edge-day.
      - `window` string, required: 24h, 7d, 30d or 90d.
      - `window_days` integer, required
    - `frozen` integer, required
    - `indexable` boolean, required
    - `name` string, required
    - `networks` integer, required: Settled networks where the entity moved stablecoins in 90 days or holds a balance.
    - `page` string, required: The entity's page: /entity/{slug}.
    - `sanctioned` integer, required
    - `slug` string, required
  - `note` string, required

## Other responses

- `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)