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

# Wallet Credit Events

> Individual credit events for one wallet with filters Polymarket does not offer: amount bounds, amount sorting, token filter.

Every individual credit a wallet has received, filterable by program, time and amount, sortable by time or amount.

<Note>
  Every event carries `username` — the recipient's Polymarket display name — where known (`null` otherwise).
</Note>

## Credit types

Every credits endpoint accepts these values in `type`/`types`:

| Value             | Program                                       |
| ----------------- | --------------------------------------------- |
| `reward`          | [Liquidity rewards](/credits/rewards)         |
| `yield`           | [Yield on balances](/credits/yield)           |
| `maker_rebate`    | [Maker rebates](/credits/maker-rebates)       |
| `taker_rebate`    | [Taker rebates](/credits/taker-rebates)       |
| `referral_reward` | [Referral rewards](/credits/referral-rewards) |

`types` accepts a comma-separated set (`types=maker_rebate,taker_rebate`) or `all`.

## Examples

Largest maker rebates first:

```bash theme={null}
curl "https://api.polynode.dev/v3/wallets/0x204f72f35326db932158cba6adff0b9a1da95e14/credits?types=maker_rebate&sort=amount&order=desc&limit=20" \
  -H "x-api-key: $POLYNODE_API_KEY"
```

Yield credits during one week:

```bash theme={null}
curl "https://api.polynode.dev/v3/wallets/0x204f72f35326db932158cba6adff0b9a1da95e14/credits?types=yield&start_ts=1783036800&end_ts=1783641600" \
  -H "x-api-key: $POLYNODE_API_KEY"
```


## OpenAPI

````yaml GET /v3/wallets/{addr}/credits
openapi: 3.1.0
info:
  title: PolyNode API
  description: >-
    Real-time Polymarket data API with decoded mempool settlements, OHLCV
    candles, and full Polygon JSON-RPC proxy.
  contact:
    name: PolyNode
    url: https://polynode.dev
  license:
    name: ''
  version: 2.0.0
servers:
  - url: https://api.polynode.dev
    description: Production
security:
  - api_key: []
paths:
  /v3/wallets/{addr}/credits:
    get:
      tags:
        - Credits
      summary: Wallet Credit Events
      description: >-
        Individual credit events for one wallet with filters Polymarket does not
        offer: amount bounds, amount sorting, token filter.
      operationId: credits_wallet_events
      parameters:
        - name: addr
          in: path
          required: true
          description: Wallet (proxy) address.
          schema:
            type: string
        - name: types
          in: query
          required: false
          description: >-
            Comma-separated set of credit types (One of `reward`, `yield`,
            `maker_rebate`, `taker_rebate`, `referral_reward`), or `all` for
            every type.
          schema:
            type: string
        - name: start_ts
          in: query
          required: false
          description: Unix seconds start bound (inclusive).
          schema:
            type: integer
        - name: end_ts
          in: query
          required: false
          description: Unix seconds end bound (inclusive).
          schema:
            type: integer
        - name: min_amount
          in: query
          required: false
          description: Minimum credit amount (USD).
          schema:
            type: string
        - name: max_amount
          in: query
          required: false
          description: Maximum credit amount (USD).
          schema:
            type: string
        - name: sort
          in: query
          required: false
          description: '`time` (default) or `amount`.'
          schema:
            type: string
        - name: order
          in: query
          required: false
          description: '`desc` (default) or `asc`.'
          schema:
            type: string
        - name: limit
          in: query
          required: false
          description: Rows per page, max 500 (default 100).
          schema:
            type: integer
        - name: offset
          in: query
          required: false
          description: Pagination offset.
          schema:
            type: integer
        - name: token
          in: query
          required: false
          description: 'Payout token filter: `usdce` or `pusd`.'
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              example:
                count: 1
                events:
                  - amount: '3714.480000'
                    block_number: 90017147
                    log_index: 2043
                    recipient: '0x204f72f35326db932158cba6adff0b9a1da95e14'
                    timestamp: 1783730716
                    token: pusd
                    tx_hash: >-
                      0xb3b589e87145a7a61324bca2a241c891fd488cf0615e5c2d7a3121b28698d7a6
                    type: maker_rebate
                    username: swisstony
                limit: 1
                offset: 0
                wallet: '0x204f72f35326db932158cba6adff0b9a1da95e14'
components:
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: x-api-key

````