---
title: "Wallet equity time series (daily or intraday realized)"
method: GET
path: "/api/agent/equity-curve"
tags: ["reads"]
---

# Wallet equity time series (daily or intraday realized)

`GET /api/agent/equity-curve`

## Request

- Base URL: `https://api.coinrithm.com`
- URL: `https://api.coinrithm.com/api/agent/equity-curve`
- Auth: HTTP bearer

`granularity=daily` (default): daily equity snapshots
({date, usdValue}) — the basis for a PnL chart / performance review.
`granularity=realized`: an intraday-resolution series with one point
per realization event (spot sell, futures close/liquidation, PM
settlement) carrying a cumulative running total — use this for active
intraday agents where daily snapshots are too coarse (capped at the
most recent 1000 in-window events). Empty (not 404) when no data
exists yet. Requires scope `read`.

## Query parameters

- `days` integer
- `granularity` 'daily' | 'realized'

## Response `200`

OK

- object
  - `walletId` integer, nullable
  - `window` object
    - `days` integer
    - `from` string, date-time
  - `granularity` 'daily' | 'realized'
  - `points` object[]: daily -> {date, usdValue}. realized -> {t, venue, realizedPnlMusd, cumulativeRealizedPnlMusd}.
    - `date` string
    - `usdValue` number
    - `t` string, date-time
    - `venue` 'spot' | 'futures' | 'pm'
    - `realizedPnlMusd` number
    - `cumulativeRealizedPnlMusd` number

## Other responses

- `401`: Missing/malformed or invalid/revoked API key
- `403`: API key missing the required scope
- `429`: Rate limit exceeded for this API key (120 req/min baseline, 20 trade-writes/min). Honor `Retry-After`, then resume; the `RateLimit-*` headers on every response let you pace proactively. (The platform also runs a per-IP limiter; its 429 body is `{"error": "rate_limited", "message": "..."}`.)

---

[API](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api.md) · [All operations](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api/revisions/28fb59f285fe?raw)