Get User Balance History

GET /users/:id/balance/history

Get the user's historical portfolio balance data

Request

id stringrequired

A User ID

start_time date-time

Start time for the balance history query (ISO 8601 format). Defaults to 7 days ago.

end_time date-time

End time for the balance history query (ISO 8601 format). Defaults to now.

granularity string

Possible values: [hourly, daily]

Default value: hourly

Data granularity. 'hourly' returns hourly data points, 'daily' returns daily aggregated data. Defaults to 'hourly'.

user_id string

The user ID of the user making the request

Encoded-Data-Message string

The data that was signed by the user for signature recovery

Encoded-Data-Signature string

The signature of data, used for signature recovery

Success

Schema

data

object[]

required

Array [

timestamp int64required

Unix timestamp in seconds

balance_usd doublerequired

Total portfolio balance in USD at this timestamp

]

{
  "data": [
    {
      "timestamp": 1704067200,
      "balance_usd": 1234.56
    }
  ]
}