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

# Wallet Activity

> The wallet's splits, merges, redemptions and conversions across every market, newest first, from `coveredFrom`. With its trades, that is its whole on-chain history.



## OpenAPI

````yaml /openapi.json get /v1/wallets/{wallet}/activity
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/wallets/{wallet}/activity:
    get:
      tags:
        - Wallets
      summary: Wallet Activity
      description: >-
        The wallet's splits, merges, redemptions and conversions across every
        market, newest first, from `coveredFrom`. With its trades, that is its
        whole on-chain history.
      operationId: wallet-activity
      parameters:
        - name: wallet
          in: path
          required: true
          description: 'The wallet: 0x and 40 hex.'
          schema:
            type: string
            pattern: ^0x[0-9a-fA-F]{40}$
          example: '0x885783760858e1bd5dd09a3c3f916cfa251ac270'
        - name: limit
          in: query
          required: false
          description: Rows, 1 to 500. Out of range is clamped.
          schema:
            type: integer
            minimum: 1
            maximum: 500
            default: 100
          example: 5
        - name: before
          in: query
          required: false
          description: 'The previous page''s `next`: `ts,block,logIndex,seq`.'
          schema:
            type: string
      responses:
        '200':
          description: OK
          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:
                  wallet:
                    type: string
                    description: ''
                  block:
                    type: integer
                    description: >-
                      The trades table's cursor (can run a batch ahead of
                      positions).
                  coveredFrom:
                    type:
                      - integer
                      - 'null'
                    description: ' Unix seconds.'
                  completeThroughTs:
                    type: integer
                    description: ' Unix seconds.'
                  complete:
                    type: boolean
                    description: ''
                  activity:
                    type: array
                    items:
                      allOf:
                        - $ref: '#/components/schemas/Activity'
                        - type: object
                          properties:
                            market:
                              $ref: '#/components/schemas/Market'
                              type:
                                - null
                                - 'null'
                  next:
                    type:
                      - string
                      - 'null'
                    description: ''
              example:
                wallet: '0x885783760858e1bd5dd09a3c3f916cfa251ac270'
                block: 94812405
                coveredFrom: 1669075200
                completeThroughTs: 1790862115
                complete: true
                activity:
                  - ts: 1790859011
                    block: 94810290
                    logIndex: 77
                    seq: 0
                    tx: >-
                      0x3f6a0c0d1d7f4b0a9e2c6b8f51a2e94d7c03b6a1e8f5d2c47a9b0e1f3c5d7e9a
                    kind: redeem
                    route: wallet
                    wallet: '0x885783760858e1bd5dd09a3c3f916cfa251ac270'
                    conditionId: >-
                      0x8db33416a2d1ebde7438c80129e898f89a5deb3852ca64b37c4bf46513204409
                    shares:
                      - -1200
                      - 0
                    usd: 1200
                    market:
                      question: Example resolved market
                      slug: us-announces-end-of-iranian-blockade-by-march-31-2027
                      eventSlug: us-announces-end-of-iranian-blockade
                      image: >-
                        https://polymarket-upload.s3.us-east-2.amazonaws.com/example.png
                      category: Politics
                      outcomes:
                        - 'Yes'
                        - 'No'
                      negRisk: false
                next: null
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/RateLimited'
components:
  schemas:
    Activity:
      type: object
      properties:
        ts:
          type: integer
          description: Block time. Unix seconds.
        block:
          type: integer
          description: Block.
        logIndex:
          type: integer
          description: Log index.
        seq:
          type: integer
          description: The row within the log, from 0.
        tx:
          type: string
          description: Transaction hash.
        kind:
          type: string
          description: What it did.
          enum:
            - split
            - merge
            - redeem
            - convert
        route:
          type: string
          description: >-
            How it reached the contracts: wallet, collateral-adapter,
            neg-risk-adapter, auto-redeem or protocol.
        wallet:
          type: string
          description: The wallet.
        conditionId:
          type: string
          description: The market.
        shares:
          type: array
          items:
            type: number
          description: >-
            The wallet's change in outcome 0 and outcome 1 shares; received is
            positive.
        usd:
          type:
            - number
            - 'null'
          description: >-
            The wallet's change in collateral, USD; received is positive. Null
            when not known exactly. A conversion's collateral sits on its first
            row.
      description: >-
        A split, merge, redemption or neg-risk conversion, from the wallet’s
        side.
    Market:
      type: object
      properties:
        question:
          type:
            - string
            - 'null'
          description: The market's question.
        slug:
          type:
            - string
            - 'null'
          description: The market's slug on Polymarket.
        eventSlug:
          type:
            - string
            - 'null'
          description: Its event's slug.
        image:
          type:
            - string
            - 'null'
          description: An https image URL.
        category:
          type:
            - string
            - 'null'
          description: >-
            Politics, Sports, Crypto, Finance, Culture, Mentions, Weather,
            Economics or Tech; null for none of them.
        outcomes:
          type:
            - array
            - 'null'
          items:
            type: string
          description: Outcome names by outcomeIndex.
        negRisk:
          type: boolean
          description: Part of a neg-risk (multi-outcome) event.
      description: Polymarket's metadata for a market.
    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.