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

# Get Trader Rewards

> Returns the trader's reward records (yield, maker/taker rebates, referral rewards) ordered by block time descending.



## OpenAPI

````yaml openapi.json GET /v1/trader/{address}/rewards
openapi: 3.1.0
info:
  title: Orbscan Open API
  description: >-
    REST endpoints for Polymarket trader activity, deposits & withdrawals, and
    per-transaction action details, sourced directly from on-chain data.
  version: 1.0.0
servers:
  - url: https://api.orbscan.com
    description: Production
security:
  - bearerAuth: []
paths:
  /v1/trader/{address}/rewards:
    get:
      summary: Get trader rewards
      description: >-
        Returns the trader's reward records (yield, maker/taker rebates,
        referral rewards, etc.), ordered by block time descending.
      operationId: getTraderRewards
      parameters:
        - name: address
          in: path
          required: true
          description: Trader address, `0x` + 40 hex chars.
          schema:
            type: string
            example: '0x0484e64092ba4108c2786b61e6fc052d3bf41b1a'
        - name: types
          in: query
          required: false
          description: >-
            Comma-separated activity types (e.g. `?types=YIELD,MAKER_REBATE`).
            Case-insensitive. Supported values: `YIELD`, `MAKER_REBATE`,
            `TAKER_REBATE`, `REFERRAL_REWARD`, `REWARD`.
          schema:
            type: string
            example: YIELD,MAKER_REBATE
        - name: fromTimestamp
          in: query
          required: false
          description: Inclusive lower timestamp (Unix seconds).
          schema:
            type: integer
            format: int64
        - name: toTimestamp
          in: query
          required: false
          description: Inclusive upper timestamp (Unix seconds).
          schema:
            type: integer
            format: int64
        - name: limit
          in: query
          required: false
          description: Page size. Defaults to 20, maximum 100.
          schema:
            type: integer
            default: 20
            maximum: 100
            minimum: 1
        - name: cursor
          in: query
          required: false
          description: >-
            Pagination cursor from the previous response's `nextCursor`. Omit
            for the first page.
          schema:
            type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: OK
                  status_code:
                    type: string
                    example: '1'
                  data:
                    type: object
                    properties:
                      items:
                        type: array
                        items:
                          $ref: '#/components/schemas/RewardItem'
                      nextCursor:
                        type: string
                        nullable: true
                        description: >-
                          Cursor for the next page, or `null` when there are no
                          more results.
              example:
                message: OK
                status_code: '1'
                data:
                  items:
                    - txHash: >-
                        0x79818cc22503eb3771d4d9d78a374c9cd53e3d15d864f585390fbc74551177c5
                      logIndex: 1267
                      proxyWallet: '0x0484e64092ba4108c2786b61e6fc052d3bf41b1a'
                      fromAddress: '0x520bf77d9d34c34a6a9723f50e1dcb887ed238c5'
                      activityType: TAKER_REBATE
                      blockTimestamp: 1787011821
                      usdcSize: '1082.4748'
                      blockNumber: 92204529
                      createdAt: '2026-08-18T00:10:51.963Z'
                  nextCursor: 1787011821_1267
        '400':
          description: >-
            Invalid `address`, unsupported `types` value, negative `limit`, or
            `fromTimestamp` > `toTimestamp`.
          content:
            application/json:
              example:
                message: Invalid address format
                status_code: '0'
                data: null
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    RewardItem:
      type: object
      properties:
        txHash:
          type: string
          description: Transaction hash.
        logIndex:
          type: integer
          description: Log index.
        proxyWallet:
          type: string
          description: The trader's proxy wallet (the reward recipient).
        fromAddress:
          type: string
          description: Address the reward was sent from.
        activityType:
          type: string
          description: Reward type.
          enum:
            - YIELD
            - MAKER_REBATE
            - TAKER_REBATE
            - REFERRAL_REWARD
            - REWARD
        blockTimestamp:
          type: integer
          format: int64
          description: Block timestamp (Unix seconds).
        usdcSize:
          type: string
          description: Reward amount, in USDC.
        blockNumber:
          type: integer
          format: int64
          description: Block number.
        createdAt:
          type: string
          format: date-time
          description: Record creation timestamp (ISO 8601).
  responses:
    Unauthorized:
      description: The API key is missing or invalid.
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Missing or invalid API key
              status_code:
                type: string
                example: '0'
              data:
                type: 'null'
          example:
            message: Missing or invalid API key
            status_code: '0'
            data: null
  securitySchemes:
    bearerAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Pass your Orbscan API key as a Bearer token, formatted as `Bearer
        <your_api_key>`.

````