PaydayAPI
API reference · OTC

List coins

POSThttps://payday.direct/api/otc/list

One transaction that opens an offer and locks the coins in its vault. A fixed offer is totalPriceRaw lamports for the whole amount (the site takes a market cap and divides it over the total supply). The seller pays the deposit (about 0.0046 SOL, back when it closes) and the network fee. Refused before signing with NOT_HELD when the wallet holds less than the amount.

No API key.

Body

walletstringrequired
The wallet that signs and pays
mintstringrequired
Any pump.fun coin
amountRawstringrequired
Raw units to lock
mode"fixed" | "market"required
account (fees to an account) or cash_payback (fees to holders)
totalPriceRawstring
fixed: lamports for the whole amount
offsetBpsinteger
market: your price against the market
floorTotalRawstring
market, optional: lamports the whole amount must never sell under
minFillRawstring
Optional smallest fill, raw units
expiresAtintegerrequired
Unix seconds, 10 minutes to 90 days from now
buyerstring
Optional: the only wallet that may fill
quote"sol"
v1 is SOL only

Responses

200OK
400Refused; nothing to sign
429Over the limit. Retry-After says when to try again.

Response fields

okboolean
txstring
Unsigned v0 transaction, base64. The wallet is its only signer and fee payer
unitsinteger | null
Compute units the test run used
networkFeeLamportsinteger
Network fee for this transaction
listingstring
list: the new listing's address
rentLamportsinteger
Deposits this transaction opens (listing and vault, or your token account); a listing's come back when it closes
rentNotestring | null
paystring
fill: what you pay, fee included. Lamports, as an integer string
feestring
fill: the 5% part of pay. Lamports, as an integer string
toSellerstring
fill: what the seller gets. Lamports, as an integer string
maxPaystring
fill: your limit; the fill fails rather than pay more. Lamports, as an integer string
lockedPriceobject | null
fill, market offers: lamports per token unit as num/den, as of the test run
lockedPrice.numstring
lockedPrice.denstring
flooredboolean
fill, market offers: the market fell more than 3% under the offer's reference, so it is priced at the reference less 3% until that catches up
amountRawstring
fill: the amount this transaction buys. Smallest token units, as an integer string