PaydayAPI
Guides

Track an account's payouts

What an X account earned, was paid, and what is on the way.

View as Markdown
curl -H "X-API-Key: pd_YOUR_KEY" https://payday.direct/api/v1/accounts/examplehandle

The answer has the account's fees (earned_usd, paid_usd, on_the_way_usd), the progress of its next payout (next_batch), its coins and its last 20 payouts.

How a payout happens

  1. Every coin naming the account collects creator fees on pump.fun.
  2. Once the account's share reaches the payout threshold, Payday lists a payout order on Peer, a peer-to-peer marketplace on Base. next_batch.progress_usd and threshold_usd show how close it is.
  3. A Peer buyer pays the account on X Money (or Cash App, Venmo or Zelle) and receives the USDC. The order moves through listed, matched, partially_paid and paid.

/payouts?handle=examplehandle&status=paid lists every paid order with its Peer link.

Every account

/accounts?sort=earned (or paid, coins) lists every account that earns fees, 200 a page.