Global Credit Stats

Program-wide aggregates per credit type: totals, unique recipients, batch transaction counts, average credit size, plus a bucketed series.

GET /v3/credits/stats

Global Credit Stats

cURL

curl --request GET \
  --url https://api.polynode.dev/v3/credits/stats \
  --header 'x-api-key: <api-key>'

200

{
  "interval": "month",
  "series": [
    {
      "bucket": 1780272000,
      "taker_rebate": {
        "amount": "6006789.660200",
        "count": 63921
      }
    },
    {
      "bucket": 1782864000,
      "taker_rebate": {
        "amount": "7673425.065000",
        "count": 95078
      }
    }
  ],
  "totals": {
    "taker_rebate": {
      "amount": "13680214.725200",
      "avg_credit": "86.039627",
      "batch_txs": 501,
      "count": 158999,
      "first_ts": 1781913600,
      "last_ts": 1783728000,
      "unique_recipients": 36469
    }
  }
}

Program-wide totals and time series: how much Polymarket pays out per program, to how many wallets, at what average size.

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

Monthly payout volumes for every program:

curl "https://api.polynode.dev/v3/credits/stats?types=all&interval=month" \
  -H "x-api-key: $POLYNODE_API_KEY"

Taker rebates by day since launch:

curl "https://api.polynode.dev/v3/credits/stats?types=taker_rebate&interval=day" \
  -H "x-api-key: $POLYNODE_API_KEY"

unique_recipients is exact for all-time requests and null when you pass start_ts/end_ts. interval=hour requires a window of 7 days or less.

Authorizations

x-api-key · string · header · required

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.

start_ts · integer

Unix seconds start bound (inclusive).

end_ts · integer

Unix seconds end bound (inclusive).

Response

200 - application/json

Success