PaydayAPI
API reference · OTC

Fill an offer

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

One transaction: the buyer pays in SOL, 95% to the seller, 5% to the PAYDAY buy and burn, coins to the buyer. Market offers are priced on chain when it lands and carry your limit (maxPay). If the price moves past it (errCode 6016) or within the same block (NO_FILL_PRICE_MOVED, 6022), build the fill again, show the buyer the new pay and ask again.

No API key.

Body

walletstringrequired
The wallet that signs and pays
listingstringrequired
amountRawstringrequired
Raw units to buy

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