Wallet Credit Series

Time-bucketed earnings series per credit type for one wallet.

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

Wallet Credit Series

cURL

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

200

{
  "wallet": "0x204f72f35326db932158cba6adff0b9a1da95e14",
  "interval": "day",
  "series": [
    {
      "bucket": 1783641600,
      "maker_rebate": {
        "amount": "3857.120000",
        "count": 1
      }
    },
    {
      "bucket": 1783728000,
      "maker_rebate": {
        "amount": "3714.480000",
        "count": 1
      }
    }
  ]
}

Bucketed earnings over time for one wallet. Use fill=zero for continuous buckets when charting.

Owner addresses. Pass an owner EOA as the wallet address and the response combines the EOA’s Polymarket wallets (Safe, proxy, deposit wallets) that have data for this endpoint. Passing a Safe, proxy or deposit wallet returns just that wallet, as before. Combined responses list the combined wallets in wallets. See Owner addresses.

​

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.

​

Example

Weekly rebate earnings, chart-ready:

curl "https://api.polynode.dev/v3/wallets/0x204f72f35326db932158cba6adff0b9a1da95e14/credits/series?types=maker_rebate,taker_rebate&interval=week&fill=zero" \
  -H "x-api-key: $POLYNODE_API_KEY"

​

Owner address fields

Present only when you pass an owner EOA. See Owner addresses.

Field	Type	Description
wallets	array	The combined wallets, in a fixed order, each {wallet, type} with type one of eoa, safe, proxy, or deposit_wallet

Buckets are summed per bucket across the combined wallets, and wallet stays the address you passed.

Authorizations

x-api-key · string · header · required

Path Parameters

addr · string · required

Wallet (proxy) address, or an owner EOA to combine every Polymarket wallet it owns.

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.

interval · string

hour, day (default), week, or month.

fill · string

zero to emit empty buckets, skip (default) to omit them.

start_ts · integer

Unix seconds start bound (inclusive).

end_ts · integer

Unix seconds end bound (inclusive).

Response

200 - application/json

Success

Owner-address responses add the optional fields below. See the page for the full response.

wallets · object[]

Present only when you pass an owner EOA: the combined wallets, in a fixed order.

Show child attributes