Account Statistics

Use account statistics to retrieve historical time-series metrics for a trading sub-account, including equity, PnL, trading volume, and ROI.

REST Endpoint

GET /api/v1/account/statistics

Query Parameters

Parameter	Required	Description
`sub_account_address`	No	Sub-account to query. If omitted, the backend determines the accessible account(s) from the authenticated user.
`start_time`	No	Start timestamp in Unix milliseconds.
`end_time`	No	End timestamp in Unix milliseconds.
`step`	No	Aggregation interval. Supported values: `hour`, `day`, `week`, `month` (aliases `h`, `d`, `w`, `m` are also accepted).
`limit`	No	Maximum number of records to return.
`sorting_order`	No	Sort order: `asc` or `desc`.

TypeScript SDK

Retrieve account statistics:

const statistics = await client.account.getStatistics({
  sub_account_address,
  start_time,
  end_time,
  step: "day",
  limit: 100,
  sorting_order: "desc",
});

Example

curl \
  -H "Authorization: Bearer <jwt>" \
  "https://api.cnt.ekiden.fi/api/v1/account/statistics?sub_account_address=<sub_account_address>"

Response Fields

Each entry may include:

timestamp
sub_account_address
equity
realised_pnl_cum
unrealised_pnl
volume
roi

The exact response schema is documented in the API Reference.

Overview

Getting Started

Setup

Fund Your Account

Market Data

Trade

Market Make

Account & Portfolio

Access Controls

Troubleshooting

RESTful API

WebSocket Guide

Websoket Reference (AsyncAPI)

REST Endpoint

Query Parameters

TypeScript SDK

Example

Response Fields

​REST Endpoint

​Query Parameters

​TypeScript SDK

​Example

​Response Fields

REST Endpoint

Query Parameters

TypeScript SDK

Example

Response Fields