Wallet Credit Events

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

GET /v3/wallets/{addr}/credits

Wallet Credit Events

cURL

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

200

{
  "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"
}

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

Every event carries username — the recipient’s Polymarket display name — where known (null otherwise).

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.

​

Examples

Largest maker rebates first:

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:

curl "https://api.polynode.dev/v3/wallets/0x204f72f35326db932158cba6adff0b9a1da95e14/credits?types=yield&start_ts=1783036800&end_ts=1783641600" \
  -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
events[].wallet	string	The wallet this row belongs to

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.

start_ts · integer

Unix seconds start bound (inclusive).

end_ts · integer

Unix seconds end bound (inclusive).

min_amount · string

Minimum credit amount (USD).

max_amount · string

Maximum credit amount (USD).

sort · string

time (default) or amount.

order · string

desc (default) or asc.

limit · integer

Rows per page, max 500 (default 100).

offset · integer

Pagination offset.

token · string

Payout token filter: usdce or pusd.

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

events · object[]

Show child attributes