---
title: "Get trade stats"
method: GET
path: "/evm/rh/trade-stats"
tags: ["Robinhood Chain"]
---

# Get trade stats

`GET /evm/rh/trade-stats`

Get a server-side trade aggregate for a Bags V2 token on Robinhood Chain over a rolling window (volume, transaction counts, last price).

The aggregate streams the full window from the subgraph; `truncated` is `true` only in the pathological case where the window exceeds the ~500k-trade safety bound, in which case `volumeEthWei` and counts are a lower bound.

## Query parameters

- `tokenAddress` string, required
- `windowSecs` number

## Response `200`

Successfully retrieved trade stats

- object
  - `success` boolean, required
  - `response` object
    - `windowSecs` number, required — Aggregation window in seconds.
    - `volumeEthWei` string, required — Total ETH volume within the window (wei), as string to support bigint.
    - `txCount` number, required — Total number of trades within the window.
    - `buyCount` number, required — Number of buys within the window.
    - `sellCount` number, required — Number of sells within the window.
    - `truncated` boolean, required — True only in the pathological case where the window exceeded the ~500k-trade safety bound before being fully scanned; volume and counts are then a lower bound. False on the normal path.
    - `lastPriceEthPerToken` string, nullable, required — Spot price after the most recent trade, as an 1e18 fixed-point decimal string (ETH per whole token). Null when the token has no trades.
    - `lastTradeTimestamp` number, nullable, required — Unix-seconds timestamp of the most recent trade. Null when the token has no trades.

## Other responses

- `400` — Bad request - Invalid token address or window
- `401` — Unauthorized - Invalid or missing API key
- `500` — Internal server error

---

[API](https://skmtc.net/bags/apis/bags-public-api-v2.md) · [All operations](https://skmtc.net/bags/apis/bags-public-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bags/bags-public-api-v2/revisions/4a14b82cd39d/schema)