> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anthid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List traded symbols

> Returns the symbols the caller's organization traded in the trailing window, unioned with those it still holds, sorted ascending. Intended to be fetched once and indexed by the client for prefix search, so the list is deliberately small and cheap rather than paginated.



## OpenAPI

````yaml /api-reference/ledger.openapi.json get /v1/ledger/symbols/traded
openapi: 3.1.0
info:
  title: ledger
  description: ''
  license:
    name: ''
  version: 0.1.0
servers:
  - url: https://api.anthid.com
    description: Production
security: []
tags:
  - name: Ledger
    description: Read current orders, order history, and order activity
  - name: Ledger
    description: Read current positions and position history
  - name: Ledger
    description: Read platform-wide execution metrics
  - name: Ledger
    description: >-
      Read ledger-wide reference data, such as the symbols an organization has
      traded
  - name: Ledger
    description: >-
      Read completed intents. Live ones are served by the intents service at
      /v1/intents; this is the six year record of finished ones
paths:
  /v1/ledger/symbols/traded:
    get:
      tags:
        - Ledger
      summary: List traded symbols
      description: >-
        Returns the symbols the caller's organization traded in the trailing
        window, unioned with those it still holds, sorted ascending. Intended to
        be fetched once and indexed by the client for prefix search, so the list
        is deliberately small and cheap rather than paginated.
      operationId: getTradedSymbols
      parameters:
        - name: account_id
          in: query
          description: >-
            Trading account to narrow to. Omitted spans every account the
            organization owns.
          required: false
          schema:
            type: string
            format: uuid
          example: 550e8400-e29b-41d4-a716-446655440000
        - name: environment
          in: query
          description: >-
            Required. Which environment the read covers. Resolved to the
            organization's accounts in that environment, including disabled and
            deleted ones, since the ledger stores no environment of its own.
            Rejected with 400 when it disagrees with the account named alongside
            it.
          required: true
          schema:
            $ref: '#/components/schemas/BrokerEnvironment'
          example: paper
        - name: days
          in: query
          description: >-
            Trailing day count. Defaults to 1, clamped to 365, then to the
            window the caller's plan grants.
          required: false
          schema:
            type: integer
            format: int64
          example: 1
      responses:
        '200':
          description: Symbols retrieved
          headers:
            anthid-retention-days:
              schema:
                type: integer
                format: int64
              description: >-
                Trailing window, in days, that this answer was produced under.
                Comes from the caller's plan, so a value shorter than the range
                requested means the range was narrowed to it. Absent for
                internal service callers, who have no window.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TradedSymbolsResponse'
              example:
                data:
                  - AA
                  - AAPL
                  - MSFT
                  - NVDA
                days: 1
        '401':
          description: Missing or invalid authentication credentials
          content:
            text/plain:
              schema:
                type: string
        '403':
          description: Caller cannot read this organization's activity
          content:
            text/plain:
              schema:
                type: string
        '429':
          description: Caller exceeded the request rate limit
          content:
            text/plain:
              schema:
                type: string
        '500':
          description: Unexpected server error while listing symbols
          content:
            text/plain:
              schema:
                type: string
      security:
        - bearerAuth: []
        - apiKeyAuth: []
components:
  schemas:
    BrokerEnvironment:
      type: string
      enum:
        - paper
        - live
    TradedSymbolsResponse:
      type: object
      description: >-
        The symbols an organization has traded in a window, or still holds.


        Sorted ascending, so a caller can index it for prefix search without
        sorting

        it again. Held positions are folded in regardless of when they were
        opened:

        a symbol carried from before the window is one an operator still expects
        to

        find by typing it.
      required:
        - data
        - days
      properties:
        data:
          type: array
          items:
            type: string
        days:
          type: integer
          format: int64
          description: >-
            Trailing window the list was built from, echoed back so a caller
            does

            not have to remember what it asked for. Clamped, so this can differ
            from

            what was sent.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````