Reference

Volume

Historical trading volume and fees per protocol, aggregated straight from the fill journal. Volume counts traded notional (liquidations carry no size delta and are excluded by construction); fees use the order-fee basis, excluding funding and borrow charges. Buckets with no fills are omitted.

Volume history

GET

Traded volume and fees per bucket across GMTrade markets. Full history reaches back to protocol launch (March 2025).

History depth

Starter · 30dPro · 90dPremium · Full

Headers

x-api-keystringrequired

API key sent in the request header; never accepted as a query parameter.

Query parameters

marketstring

Filter to a market. Results may aggregate protocol-native variants that share the market symbol.

interval5m | 15m | 1h | 4h | 1d

Aggregation bucket size.

fromstring

Inclusive window start as an RFC 3339 timestamp; defaults per endpoint.

tostring

Exclusive window end as an RFC 3339 timestamp; defaults to the current time.

Response

200

{ interval, from, to, data: Bucket[] }

Bucket

timeStart of the aggregation bucket.

volume_usdTraded notional in the bucket (USD).

fees_usdTrading fees collected in the bucket.

Request

cURL

curl --request GET \
  --url https://api.perpdb.xyz/v1/gmtrade/volume/history?market=SOL-PERP&interval=1h \
  --header 'x-api-key: ak_...'

Example

{
  "interval": "1h",
  "from": "2026-08-01T23:39:01.799Z",
  "to": "2026-08-15T23:39:01.799Z",
  "data": [
    {
      "time": "2026-08-01T23:00:00.000Z",
      "volume_usd": 2702.99281304,
      "fees_usd": 0.256783779615
    },
    {
      "time": "2026-08-02T00:00:00.000Z",
      "volume_usd": 318985.7479702607,
      "fees_usd": 31.561405947226
    }
  ]
}