API reference · OTC
List coins
POST
https://payday.direct/api/otc/listOne 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
walletstringrequiredThe wallet that signs and pays
mintstringrequiredAny pump.fun coin
amountRawstringrequiredRaw units to lock
mode"fixed" | "market"requiredaccount (fees to an account) or cash_payback (fees to holders)totalPriceRawstringfixed: lamports for the whole amount
offsetBpsintegermarket: your price against the market
floorTotalRawstringmarket, optional: lamports the whole amount must never sell under
minFillRawstringOptional smallest fill, raw units
expiresAtintegerrequiredUnix seconds, 10 minutes to 90 days from now
buyerstringOptional: 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
okbooleantxstringUnsigned v0 transaction, base64. The wallet is its only signer and fee payer
unitsinteger | nullCompute units the test run used
networkFeeLamportsintegerNetwork fee for this transaction
listingstringlist: the new listing's address
rentLamportsintegerDeposits this transaction opens (listing and vault, or your token account); a listing's come back when it closes
rentNotestring | nullpaystringfill: what you pay, fee included. Lamports, as an integer string
feestringfill: the 5% part of pay. Lamports, as an integer string
toSellerstringfill: what the seller gets. Lamports, as an integer string
maxPaystringfill: your limit; the fill fails rather than pay more. Lamports, as an integer string
lockedPriceobject | nullfill, market offers: lamports per token unit as num/den, as of the test run
lockedPrice.numstringlockedPrice.denstringflooredbooleanfill, 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
amountRawstringfill: the amount this transaction buys. Smallest token units, as an integer string