API reference · Coins
List coins
GET
https://payday.direct/api/v1/coinsPayday coins on every chain, newest first by default. Filter by chain, status, account, pairing or basket, and sort by market cap, volume or holders.
Needs an API key in Authorization: Bearer or X-API-Key. Authentication
Query parameters
limitintegerdefault 50How many to return
cursorstringnext_cursor from the previous page
status"curve" | "graduated"Only this status
handlestringX handle the coin pays
pair"sol" | "stock"sol for SOL pairs, stock for stock pairsbasket"any" | "payout" | "fund"basket coins only: any (mixed included) or one type; each coin carries cash_payback.basket { type, icon, legs, payback, rules }
chain"solana" | "elysium"Only this chain
sincestringcreated after
sort"new" | "market_cap" | "volume" | "holders"default "new"The order
Responses
200OK
401Missing or invalid key
429Over the limit. Retry-After says when to try again.
Response fields
mintstringThe coin's address: a Solana mint, or an EVM token address in lower case
symbolstringticker, case kept
namestringThe coin's name
imagestring | nullThe coin's picture
created_atstringWhen the coin launched
status"curve" | "graduated"curve on the bonding curve, graduated once it moved to the pump.fun AMMcurve_progress_bpsinteger | nullBonding curve progress in basis points; 10000 when graduated
quoteobjectThe asset the coin trades against
quote.mintstringThe pairing's mint
quote.symbolstringThe pairing's ticker
marketobjectMarket data
market.market_cap_usdstring | nullUS dollars with 2 decimals
market.volume_24h_usdstring | nullUS dollars with 2 decimals
market.liquidity_usdstring | nullUS dollars with 2 decimals
market.holdersinteger | nullWallets holding the coin, counted on chain
market.price_change_24h_pctnumber | nullPrice change over 24 hours, in percent
market.last_trade_atstring | nullThe last trade
recipientobject | nullThe account the coin pays, or null for a Cash Payback coin
recipient.rail"xmoney" | "cashapp" | "venmo" | "zelle"xmoney, cash, venmo or zellerecipient.handlestring | nullX handle; null for Cash App, Venmo and Zelle
dexobject | nullThe DexScreener reimbursement:
filling, claimable, claimed and so ondex.status"filling" | "claimable" | "claiming" | "claimed" | "forfeit"Where the reimbursement stands
dex.reserved_usdstring | nullUS dollars with 2 decimals
dex.target_usdstring | nullUS dollars with 2 decimals
dex.sent_txstring | nullThe transaction that paid it
dex.sent_atstring | nullWhen it was paid
linksobjectWhere to see the coin