PaydayAPI
Guides

Trade any pump.fun coin OTC

Lock coins at your price, fill an offer, cancel or return it: one wallet-signed transaction each.

The OTC locker lets one wallet sell any pump.fun coin to another at a price the seller sets. The coins wait in a vault owned by an on-chain program (the locker) until someone buys them. Payday never holds the coins, never signs for anyone and has no key that can move them.

How a trade works

  1. The seller lists. POST /otc/list builds one transaction that opens the offer and moves the coins into its vault. The price is either fixed (the site takes it as a market cap, the way pump.fun shows one, and turns it into SOL over the total supply) or the market price with an offset from -5% to +5%. The seller picks the expiry, from 10 minutes to 90 days, and can name the one wallet allowed to buy (a private deal), a smallest fill, and for market offers a floor it never sells under.
  2. The buyer fills. POST /otc/fill builds one transaction that does everything at once: the buyer pays in SOL, 95% goes to the seller, 5% goes to the Payday buy and burn, and the coins go to the buyer. If any part fails, nothing moves. A buyer can take part of an offer; the last buyer takes what is left.
  3. Or it closes. The seller can cancel at any time (POST /otc/cancel). Once an offer expires, anyone can send it back (POST /otc/return); the coins only ever go to the seller. Neither costs a fee.

Every route answers an unsigned transaction for the wallet in wallet. Have the wallet sign it (signTransaction, one transaction at a time), then send it with POST /otc/send and wait with GET /otc/confirm/{sig}. Payday test-runs every transaction before it answers, so a refusal comes back as a 400 with a code before anyone signs.

curl -X POST https://payday.direct/api/otc/fill -H "Content-Type: application/json" \
  -d '{"wallet":"BUYER_WALLET","listing":"LISTING_ADDRESS","amountRaw":"250000000000"}'

Fees

  • 5% of each fill, in SOL, out of the buyer's payment. The program takes it inside the fill and sends it to the address in its config, the payout wallet's PAYDAY burn stack, which buys and burns PAYDAY on its own pacing. Nothing is taken in the listed coin, and nothing is ever sold on your coin's chart, basket coins included.
  • No fee to list, cancel or return.
  • Network fees: each side pays its own (about 0.00001 SOL a transaction). The seller pays a deposit of about 0.0046 SOL to open the offer and its vault; it comes back to the seller when the offer closes. A buyer who has never held the coin pays to open their own token account.

Prices

v1 prices every offer in SOL. A market offer reads the price on chain at the moment it fills, from the coin's pump.fun bonding curve or, once it has graduated, its pump.fun pool, and records that price on the fill (lockedPrice). A coin that trades against USDC is priced through the SOL/USDC rate the program reads from a deep SOL/USDC pool; a coin paired with anything else takes fixed offers only. Pages show every price as a market cap on the total supply, the way pump.fun does.

The buyer's transaction carries a limit (maxPay), 1% over the price at the test run. If the price moves past it before the transaction lands, nothing moves; build the fill again and show the buyer the new amount. The site does this for you and asks the buyer to confirm the new price, so a normal price move is never shown as a failure.

The program refuses a market fill sent together with a swap or any other program's instruction, so a price cannot be pushed inside the same transaction. It also keeps a reference price for each offer: a fill never prices under the reference less 3% (floored says when that applies), and the reference comes down 3% a minute through POST /otc/refresh, which anyone can send.

Which coins

Any pump.fun coin, Payday's or not: the program checks the coin's pump.fun bonding curve on chain, and refuses coins that can still be minted or frozen and Token-2022 coins with features pump.fun coins do not have. GET /otc/coin/{mint} gives the same answer before anyone signs (problem), with the name, picture, market price and liquidity, and ?wallet= says how much a wallet holds. A wallet that does not hold enough cannot list.

Payouts while listed

Coins in the locker are not counted as held: they earn no Cash Payback rounds, basket dividends or airdrops while they sit there. The vault owner (vaultAuthority in GET /otc/config) is left out of every holder payout. Selling more than 80% of a bag, which includes moving it into the locker, restarts its hold time.

Codes to branch on

CodeMeaning
NOT_HELDThe wallet does not hold the coin, or holds less than the amount
NOT_ALLOWEDNot a pump.fun coin, or a coin the locker refuses
SOL_ONLYA price in anything but SOL
QUOTE_MISMATCHA market offer for a coin with no market price in SOL (paired with something other than SOL or USDC)
BAD_EXPIRY, BAD_OFFSETExpiry outside 10 minutes to 90 days; offset outside -5% to +5%
NOT_BUYER, NOT_SELLERA private offer for another wallet; only the seller can cancel
NO_FILL_BELOW_MIN, NO_FILL_TAKE_RESTUnder the smallest fill, or would leave less than it behind
NO_FILL_PRICE_MOVEDThe price changed in this block: build the fill again in a moment
PAUSEDNew offers and fills are paused; cancel and return still work