Recipient Growth

How many wallets earned their first credit per bucket — program growth over time.

GET /v3/credits/recipients/stats

Recipient Growth

cURL

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

200

{
  "interval": "month",
  "series": [
    {
      "bucket": 1772323200,
      "new_recipients": 556
    },
    {
      "bucket": 1775001600,
      "new_recipients": 3101
    },
    {
      "bucket": 1777593600,
      "new_recipients": 1850
    },
    {
      "bucket": 1780272000,
      "new_recipients": 1756
    },
    {
      "bucket": 1782864000,
      "new_recipients": 489
    }
  ]
}

New earning wallets per bucket, per program — a clean read on each program’s adoption.

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

New referral earners per month:

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

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.

Response

200 - application/json

Success