---
title: "Stablecoin Overview"
method: GET
path: "/gateway/v1/stablecoin/overview"
tags: ["Stablecoin"]
---

# Stablecoin Overview

`GET /gateway/v1/stablecoin/overview`

## Request

- Base URL: `https://api.asksurf.ai`
- URL: `https://api.asksurf.ai/gateway/v1/stablecoin/overview`
- Auth: HTTP bearer

Returns period stablecoin totals by asset.

## Query parameters

- `asset_id` string: Canonical stablecoin asset id.
- `chain` string: Optional chain.
- `token_address` string: Deployment address; requires chain.
- `from` string: Inclusive UTC date YYYY-MM-DD.
- `to` string: Exclusive UTC date YYYY-MM-DD.
- `sort_by` 'transfer_volume' | 'transfer_volume_usd' | 'transfer_count': Sort field.
- `order` 'asc' | 'desc': Sort order.
- `limit` integer: Results per page.
- `offset` integer: Rows to skip.

## Response `200`

OK

- DataResponseStablecoinOverview
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `data` StablecoinOverview[], nullable, required
    - `active_senders` integer, nullable, required
    - `asset_id` string, required
    - `chain` string, nullable, required
    - `first_date` string, required
    - `last_date` string, required
    - `priced_transfer_count` integer, required
    - `token_address` string, nullable, required
    - `transfer_count` integer, required
    - `transfer_volume` number, double, nullable, required
    - `transfer_volume_usd` number, double, nullable, required
  - `meta` OffsetMeta, required
    - `cached` boolean, required: Whether this response was served from cache
    - `credits_used` integer, required: Credits deducted for this request
    - `empty_reason` string: Hint explaining why the data array is empty, when applicable
    - `has_more` boolean: Whether more items may exist beyond this response. For offset-paged endpoints, continue with a larger offset. For time-series endpoints without offset/cursor controls, true means the requested time range hit an upstream cap; narrow from/to to continue. Omitted when exhaustion cannot be proven.
    - `limit` integer, required: Maximum number of items returned in this response
    - `offset` integer, required: Number of items skipped (pagination offset)
    - `total` integer: Total number of matching items (before pagination). Omitted when total is unknown.
    - `watermark` integer: Warehouse watermark (Unix seconds) this response was computed at, on warehouse-backed endpoints (e.g. Hyperliquid /trades/aggregate) — rows up to this time come from the warehouse, newer rows from the live tail. Omitted elsewhere.

## Other responses

- `default`: Error

## Changes

- **2026-10-22** `27d9ac8e8386`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/changes/gateway/v1/stablecoin/overview/get.md)

---

[API](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api.md) - [All operations](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/revisions/91774fdd5302?raw)