Wallet Credit Totals

Lifetime or time-windowed totals per credit type for one wallet, in one call. Polymarket’s own API only exposes these as a raw activity feed you would have to page and sum yourself.

GET /v3/wallets/{addr}/credits/totals

Wallet Credit Totals

cURL

curl --request GET \
  --url https://api.polynode.dev/v3/wallets/{addr}/credits/totals \
  --header 'x-api-key: <api-key>'

200

{
  "end_ts": null,
  "identity": {
    "eoa": "0xafcd9f5f78cb559c99d93f1914880df74cc3fc21",
    "other_wallets": [],
    "username": "swisstony",
    "wallet_type": "safe",
    "deployed": true,
    "current": true,
    "wallet_details": [
      {
        "address": "0x204f72f35326db932158cba6adff0b9a1da95e14",
        "wallet_type": "safe",
        "deployed": true,
        "current": true
      }
    ]
  },
  "start_ts": null,
  "total_amount": "1667868.567600",
  "totals": {
    "maker_rebate": {
      "amount": "303821.696700",
      "count": 130,
      "first_ts": 1772075366,
      "last_ts": 1783730716
    },
    "taker_rebate": {
      "amount": "1364046.870900",
      "count": 39,
      "first_ts": 1781914210,
      "last_ts": 1783728617
    }
  },
  "wallet": "0x204f72f35326db932158cba6adff0b9a1da95e14"
}

Total credits received by a wallet, per program, in one call. Add start_ts/end_ts for time-windowed totals (for example, rebates earned this month).

The response includes an identity block with username, controlling eoa, wallet_type, deployed, current, wallet_details, and other_wallets. wallet_details separates wallet type from deployment status and identifies the account’s current trading wallet. Polymarket’s own API does not expose this anywhere.

Credit types

Every credits endpoint accepts these values in type/types:

Value	Program
reward	Liquidity rewards
yield	Yield on balances
maker_rebate	Maker rebates
taker_rebate	Taker rebates
referral_reward	Referral rewards

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

Examples

All five programs at once:

curl "https://api.polynode.dev/v3/wallets/0x204f72f35326db932158cba6adff0b9a1da95e14/credits/totals" \
  -H "x-api-key: $POLYNODE_API_KEY"

Rebates only, June 2026:

curl "https://api.polynode.dev/v3/wallets/0x204f72f35326db932158cba6adff0b9a1da95e14/credits/totals?types=maker_rebate,taker_rebate&start_ts=1780272000&end_ts=1782950400" \
  -H "x-api-key: $POLYNODE_API_KEY"

Authorizations

x-api-key · string · header · required

Path Parameters

addr · string · required

Wallet (proxy) address.

Query Parameters

types · string

Comma-separated set of credit types (One of reward, yield, maker_rebate, taker_rebate, referral_reward), or all for every type.

start_ts · integer

Unix seconds start bound (inclusive).

end_ts · integer

Unix seconds end bound (inclusive).

Response

200 - application/json

Success