---
title: "Private action ledger for the current API key"
method: GET
path: "/api/agent/ledger"
tags: ["ledger"]
---

# Private action ledger for the current API key

`GET /api/agent/ledger`

## Request

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

Paginated private execution ledger for the calling API key only:
reads, quotes, writes, rejects, idempotent replays, sanitized
request/response summaries, optional trace metadata, and related
paper-trade ids. Requires scope `read`.

## Query parameters

- `venue` string
- `eventType` string
- `runId` string
- `decisionId` string
- `status` string
- `from` string, date-time
- `to` string, date-time
- `limit` integer
- `offset` integer

## Response `200`

OK

- AgentLedgerResponse
  - `data` AgentActionEvent[]
    - `id` integer
    - `method` string
    - `endpoint` string
    - `venue` string, nullable
    - `eventType` string
    - `statusCode` integer, nullable
    - `ledgerStatus` string
    - `latencyMs` integer, nullable
    - `idempotencyKey` string, nullable
    - `relatedEntityType` string, nullable
    - `relatedEntityId` string, nullable
    - `requestSummary` object, nullable
    - `responseSummary` union
      - object
      - unknown[]
        - unknown
      - string
      - number
      - boolean
    - `blockReasons` string[]
    - `runId` string, nullable
    - `decisionId` string, nullable
    - `strategyLabel` string, nullable
    - `confidence` number, nullable
    - `rationaleSummary` string, nullable: Private caller-supplied summary; never exposed publicly.
    - `startedAt` string, date-time
    - `completedAt` string, date-time, nullable
  - `pagination` object
    - `limit` integer
    - `offset` integer
    - `hasMore` boolean
    - `total` integer
  - `filters` object
  - `asOf` string, date-time

## 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)