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
mintstringSolana mint, or EVM token address in lower case
symbolstringTicker, in the case it was launched with
namestringThe coin's name
imagestring | nullPicture link
created_atstring | nullWhen 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; 10000 when graduated
quoteobjectThe asset the coin trades against
quote.mintstring | nullPairing mint; null for an EVM native coin
quote.symbolstring | nullThe pairing's ticker
marketobjectMarket data
market.market_cap_usdstring | nullUS dollars as a string with two decimals
market.volume_24h_usdstring | nullLast 24 hours. US dollars as a string with two decimals
market.liquidity_usdstring | nullUS dollars as a string with two decimals
market.holdersinteger | nullCounted 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; null for a Cash Payback coin
recipient.rail"xmoney" | "cash" | "venmo" | "zelle" | "tiktok"xmoney, cash, venmo or zellerecipient.handlestring | nullX handle; null for Cash App, Venmo and Zelle
mode"account" | "cash_payback"account (fees to an account) or cash_payback (fees to holders)cash_paybackobject | nullFor a Cash Payback coin; null for an account coin
cash_payback.detailsstringThis coin in /payback/coins/{mint}
cash_payback.category"pairing" | "basket"cash_payback.label"Holders" | "Payout basket" | "Fund basket" | "Basket"cash_payback.basketobject | nullNull for a coin paid in its pairing
cash_payback.reward_basketobject[]dexobject | nullThe DexScreener reimbursement
dex.statusstringfilling, claimable, claiming, bridging, claimed, returning, returned or forfeit
dex.reserved_usdstring | nullSet aside so far. US dollars as a string with two decimals
dex.target_usdstring | nullUS dollars as a string with two decimals
dex.sent_txstring | nullThe transaction that paid it
dex.sent_atstring | nullWhen it was paid
chainstringsolana, or the EVM chain's key (elysium)
chain_idinteger | nullEVM chain id; null on Solana
linksobjectWhere to see the coin
links.pagestringlinks.pumpstringSolana only
links.explorerstringEVM only
links.websitestring | nulllinks.xstring | nulllinks.telegramstring | null