Skip to main content
GET
/
v1
/
account
/
stats
curl
ADDR=0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb
curl "https://api.testnet.arcus.xyz/v1/account/stats?address=${ADDR}"
{
  "address": "<string>",
  "rollingVolume": 123,
  "lifetimeVolume": 123,
  "lifetimeFeesPaid": 123,
  "tradingFeeTier": {
    "level": 123,
    "makerFeeBps": 123,
    "takerFeeBps": 123
  }
}
Returns trading statistics for any Ethereum address: 30-day rolling notional fill volume and the current trading fee tier (level + BPS). This endpoint always returns 200 — a brand-new address with no activity yields rollingVolume: 0 and tradingFeeTier at level 0 (Base). No authentication is required.

Query Parameters

​
address
string
required

Master Ethereum address for this API key (must match address from POST /createApiKey for the same key). Required on REST for account-scoped reads and for place/cancel. Invalid hex → 400; mismatch with key → 403.

20-byte EVM address as hex: optional 0x or 0X prefix and exactly 40 hexadecimal digits. API responses normalize to lowercase a–f after 0x.

Pattern: ^(0x|0X)?[0-9a-fA-F]{40}$

Response

Account stats.

Account statistics for any Ethereum address. Always returns 200 — a fresh address with no activity yields rollingVolume: 0 and tradingFeeTier at level 0 (Base). Never 404s.

​
address
string
required

Lower-case 0x-prefixed 20-byte Ethereum address.

​
rollingVolume
integer<int64>
required

Notional fill volume over the fee-tier rolling window (14 days), in quote quantums (1e9 = $1). NOTE: this is the 14d fee-tier window — use lifetimeVolume for the all-time figure. Returns 0 if ClickHouse is unreachable; the endpoint degrades gracefully rather than failing.

​
lifetimeVolume
integer<int64>
required

All-time perps notional fill volume, in quote quantums (1e9 = $1). Read from the off-write-path hourly volume rollup. 0 if ClickHouse is unreachable.

​
lifetimeFeesPaid
integer<int64>
required

All-time perps trading fees paid, in quote quantums (1e9 = $1). Read from the off-write-path hourly fees/PnL rollup. 0 if ClickHouse is unreachable.

​
tradingFeeTier
object

The account's current trading fee tier (level + maker/taker BPS). Omitted only when the fee-tier persistence layer is unavailable.