API reference · Cash Payback

Get a round

GEThttps://payday.direct/api/v1/payback/coins/{mint}/rounds/{n}

One round: every wallet paid, its amount, the delivery cost taken from its share, days held, its multiplier and the transaction.

Needs an API key in Authorization: Bearer or X-API-Key. Authentication

Path parameters

mintstringrequired

The coin's mint address (or EVM token address)

nintegerrequired

The round number, from 1

Query parameters

limitintegerdefault 50

How many to return

cursorstring

next_cursor from the previous page

Responses

200OK

401Missing or invalid key

429Over the limit. Retry-After says when to try again.

const res = await fetch("https://payday.direct/api/v1/payback/coins/MINT_ADDRESS/rounds/1", { headers: { Authorization: "Bearer " + process.env.PAYDAY_KEY }, }); const json = await res.json(); if (!res.ok) throw new Error(json.error?.code); console.log(json);

import os, requests r = requests.get( "https://payday.direct/api/v1/payback/coins/MINT_ADDRESS/rounds/1", headers={"Authorization": "Bearer " + os.environ["PAYDAY_KEY"]}, ) r.raise_for_status() print(r.json())

{ "data": [ { "wallet": "Ho1der111111111111111111111111111111111111", "role": "holder", "amount": "0.000912", "raw": "912000", "delivery_cost": "0.000002", "new_account": false, "held_days": 0.4, "boost": 1.12, "status": "sent", "tx": "3fQk...9aZ" } ], "next_cursor": "MQ", "total": 89, "round": { "mint": "3unDHbPUsLqQtoHgvuCsRSArnuhVjhsn11vRht5Xpump", "n": 3, "asset": { "mint": "So11111111111111111111111111111111111111112", "symbol": "SOL" }, "status": "done", "weighting": "time-held", "paid": "0.045607", "holders": 169, "carried_over": 80, "at": "2026-11-15T19:25:14.126Z", "done_at": "2026-11-15T19:25:24.686Z" } }