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

# Fills by Market

> Every fill of up to 100 markets in a window of up to 7 days, oldest first, as integer rows: `[market, ts, block, logIndex, outcome, side, shares, usd, exchange, isTaker, fee]`. `market` is the place in your `markets` list; side 0 is buy; shares and usd in micro-units (divide by 1,000,000); fee in micro-shares on V1 buys (exchange 1 or 2, side 0), else micro-USDC. Strict: malformed parameters are refused, never clamped. Combo fills are not included.



## OpenAPI

````yaml /openapi.json get /v1/fills
openapi: 3.1.0
info:
  title: Codex API
  version: 1.0.0
  description: >-
    Nomos's Polymarket index, rebuilt from Polygon: holders, positions, PnL,
    trades, leaderboards and live fills.
servers:
  - url: https://codex-api.nomos.trade
security:
  - bearerAuth: []
tags:
  - name: Markets
  - name: Wallets
  - name: Leaderboard
  - name: Events
  - name: Fills
  - name: Crypto Strikes
  - name: Health
paths:
  /v1/fills:
    get:
      tags:
        - Fills
      summary: Fills by Market
      description: >-
        Every fill of up to 100 markets in a window of up to 7 days, oldest
        first, as integer rows: `[market, ts, block, logIndex, outcome, side,
        shares, usd, exchange, isTaker, fee]`. `market` is the place in your
        `markets` list; side 0 is buy; shares and usd in micro-units (divide by
        1,000,000); fee in micro-shares on V1 buys (exchange 1 or 2, side 0),
        else micro-USDC. Strict: malformed parameters are refused, never
        clamped. Combo fills are not included.
      operationId: fills-markets
      parameters:
        - name: markets
          in: query
          required: true
          description: 1 to 100 condition ids, comma separated, no spaces, no repeats.
          schema:
            type: string
          example: '0x8db33416a2d1ebde7438c80129e898f89a5deb3852ca64b37c4bf46513204409'
        - name: from
          in: query
          required: true
          description: Unix seconds, inclusive.
          schema:
            type: integer
          example: 1790856000
        - name: to
          in: query
          required: true
          description: Unix seconds, exclusive; at most 604,800 after from.
          schema:
            type: integer
          example: 1790859600
        - name: limit
          in: query
          required: false
          description: ''
          schema:
            type: integer
            minimum: 1
            maximum: 50000
            default: 20000
          example: 5
        - name: after
          in: query
          required: false
          description: The previous page's `next`.
          schema:
            type: string
      responses:
        '200':
          description: 'OK. Gzipped when you send `Accept-Encoding: gzip`.'
          headers:
            x-ratelimit-limit:
              description: Your rate, requests a minute.
              schema:
                type: integer
            x-ratelimit-remaining:
              description: Requests left in your bucket.
              schema:
                type: integer
          content:
            application/json:
              schema:
                type: object
                properties:
                  block:
                    type: integer
                    description: >-
                      The trades table's cursor (can run a batch ahead of
                      positions).
                  completeThroughTs:
                    type: integer
                    description: >-
                      Every fill at or before it is in the answer; 0: nothing
                      claimable yet. Unix seconds.
                  next:
                    type:
                      - string
                      - 'null'
                    description: Send it as `after`, with the same window.
                  fills:
                    type: array
                    items:
                      type: array
                      items:
                        type: integer
                    description: Integer rows.
              example:
                block: 94812405
                completeThroughTs: 1790862115
                fills:
                  - - 0
                    - 1790856012
                    - 94808210
                    - 33
                    - 0
                    - 0
                    - 2000000000
                    - 462000000
                    - 3
                    - 1
                    - 920000
                  - - 0
                    - 1790856012
                    - 94808210
                    - 34
                    - 0
                    - 1
                    - 2000000000
                    - 462000000
                    - 3
                    - 0
                    - 0
                next: 1790856012,94808210,34
        '400':
          description: A parameter is malformed or out of range
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                e0:
                  summary: the window is at most 604800 seconds (7 days)
                  value:
                    error: the window is at most 604800 seconds (7 days)
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/RateLimited'
        '503':
          description: 'Not ready, or off: retry later'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                e0:
                  summary: trades are off
                  value:
                    error: trades are off
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
          description: What went wrong, for a person to read.
      description: Every error answer.
  responses:
    Unauthorized:
      description: No key, or an unknown or revoked one.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: unknown or revoked API key
    RateLimited:
      description: >-
        Over your rate, or more than 4 requests (2 streams) at once. Wait
        `Retry-After` seconds.
      headers:
        retry-after:
          description: Seconds to wait.
          schema:
            type: integer
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: 'rate limit: 600 requests a minute; retry in 1 s'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Your API key: `codex_` and 48 hex characters.'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.