Ledger

Get historical positions

Returns historical broker positions for the authenticated principal’s organization, optionally filtered by trading account, symbol, and time range. Callers must be scoped to an organization and have intent read access: service-account callers need intent:read; API-key callers need organization intent read permission; user callers need an organization admin, member, or read-only role. When account_id is supplied, the trading account must belong to the caller’s organization.

GET

positions

history

curl --request GET \
  --url https://api.anthid.com/v1/positions/history

{
  "data": [
    {
      "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "average_cost": {
        "integer": 123,
        "precision": 1
      },
      "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "quantity": 123,
      "received_at": "2023-11-07T05:31:56Z",
      "symbol": "<string>"
    }
  ],
  "next_cursor": "<string>"
}

Query Parameters

account_id

string<uuid>

Filter positions by trading account id

symbol

string

Filter positions by symbol. Symbols are normalized to uppercase

start

string<date-time>

Range start, inclusive. Defaults to 30 days before end when only end is supplied, otherwise defaults to 30 days before now

end

string<date-time>

Range end, exclusive. Defaults to the current time. Supplied ranges are rounded to minute boundaries and may not exceed 30 days

limit

integer<int32>

Maximum number of results to return. Defaults to 100 and is capped at 1000

Required range: x >= 0

next_cursor

string

Opaque keyset pagination cursor from a previous response

Response

Positions retrieved

data

object[]

required

Show child attributes

next_cursor

string | null

Get account controlReturns manual controls for a trading account. Service-account callers must provide `x-organization-id`; user and API-key callers read from their principal organization. The requested organization must own the trading account.

Get historical positions

curl --request GET \
  --url https://api.anthid.com/v1/positions/history

{
  "data": [
    {
      "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "average_cost": {
        "integer": 123,
        "precision": 1
      },
      "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "quantity": 123,
      "received_at": "2023-11-07T05:31:56Z",
      "symbol": "<string>"
    }
  ],
  "next_cursor": "<string>"
}

Documentation Index

Query Parameters

Response