Skip to main content
GET
/
v3
/
wallets
/
{addr}
/
credits
Wallet Credit Events
curl --request GET \
  --url https://api.polynode.dev/v3/wallets/{addr}/credits \
  --header 'x-api-key: <api-key>'
import requests

url = "https://api.polynode.dev/v3/wallets/{addr}/credits"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.polynode.dev/v3/wallets/{addr}/credits', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://api.polynode.dev/v3/wallets/{addr}/credits",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://api.polynode.dev/v3/wallets/{addr}/credits"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("x-api-key", "<api-key>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://api.polynode.dev/v3/wallets/{addr}/credits")
.header("x-api-key", "<api-key>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.polynode.dev/v3/wallets/{addr}/credits")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body
{
  "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).

Credit types

Every credits endpoint accepts these values in type/types:
ValueProgram
rewardLiquidity rewards
yieldYield on balances
maker_rebateMaker rebates
taker_rebateTaker rebates
referral_rewardReferral 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"

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).

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