API reference · Accounts and payouts

List payouts

GEThttps://payday.direct/api/v1/payouts

Payout orders on Peer, newest first, each with its Peer link. Status moves through listed, matched, partially_paid and paid (or withdrawn).

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

Query parameters

limitintegerdefault 50

How many to return

cursorstring

next_cursor from the previous page

handlestring

An X handle, with or without @

statusstring

Only this status

Responses

200OK

401Missing or invalid key

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

Response fields

idstring

The id

handlestring | null

The X handle

railstring

How the account is paid

statusstring

curve on the bonding curve, graduated once it moved to the pump.fun AMM

usdcstring | null

US dollars with 2 decimals

ratenumber

dollars paid per USDC

paid_usdstring | null

US dollars with 2 decimals

peerobject

The Peer order

peer.deposit_idstring | null

peer.urlstring | null

peer.listing_txstring | null

listed_atstring | null

closed_atstring | null

const res = await fetch("https://payday.direct/api/v1/payouts?status=paid", { 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/payouts?status=paid", headers={"Authorization": "Bearer " + os.environ["PAYDAY_KEY"]}, ) r.raise_for_status() print(r.json())

{ "data": [ { "id": "412", "handle": "examplehandle", "rail": "xmoney", "status": "paid", "usdc": "120.00", "rate": 0.8, "paid_usd": "96.00", "peer": { "deposit_id": "1834", "url": "https://www.peer.xyz/deposit/1834", "listing_tx": "0x5f0c...e21a" }, "listed_at": "2026-11-15T17:40:02.000Z", "closed_at": "2026-11-15T18:22:41.000Z" } ], "next_cursor": "MQ", "total": 288, "meta": { "updated_at": "2026-11-15T20:03:20.991Z", "api_version": "v1" } }