PaydayAPI
Changelog

Changelog

Every change to the API, newest first.

v1 only gains fields. Anything that would break a client ships as v2, announced here 90 days ahead. The server release is in each entry; GET /api/version and the spec's info.version show the one that is live.

November 2026

OTC locker

0.1.286November 16

Sell any pump.fun coin to another wallet at your price, through an on-chain locker. See the guide.

Added
  • POST /otc/list, /otc/fill, /otc/cancel, /otc/return and /otc/refresh: each answers one unsigned transaction for the wallet to sign; POST /otc/send sends it and GET /otc/confirm/{sig} follows it. No API key; served under /api/otc.
  • GET /otc/listings and /otc/listing/{id} (offers, statuses open, partly, sold, cancelled, expired, and each fill with its locked market price), GET /otc/coin/{mint} (any pump.fun coin: name, picture, market price, liquidity, and how much a wallet holds), GET /otc/holdings/{wallet} and GET /otc/config.
  • Fees: 5% of each fill in SOL, out of the buyer's payment, to the PAYDAY buy and burn. Nothing is ever sold on the coin's chart. No fee to list, cancel or return. v1 prices every offer in SOL; a USDC-paired coin's market price is turned into SOL.
  • Prices are shown as market caps (askMcapUsd, mcapUsd). A market fill that would land over its limit answers errCode 6016: build it again and confirm the new amount.

Keys need X and approval

0.1.271November 16

Every API key now belongs to an X account and is approved by Payday before it works.

Changed
  • Requesting a key (POST /keys) needs a payday.direct account signed in with X and a purpose saying what the key is for (10 to 280 characters). The key is shown once and has status: "pending"; calls with it answer 403 key_pending until Payday approves it.
  • launch: true now asks for launching. Payday grants it, or not, when approving the key; can_launch shows what was granted and launch_requested what was asked.
  • Keys already approved on an X account keep working as before.
Removed
  • Keys without a sign-in. Keys made that way are revoked, and GET /keys needs a sign-in.

DEX reserves that do not fill are burned

0.1.269November 15
Added
  • dex.status on coins can be burned: the reserve was not full 3 days after the coin was minted, so what it held bought and burned the Payday token. A reserve that already sent part of its money to its launcher is never burned. The 3 days is a starting point and may change as holders decide; changes are posted on Telegram.

API updates on Telegram

0.1.268November 15
Added
  • A Telegram channel for API updates, t.me/paydayann, linked at the top of every docs page. Every change in this changelog is posted there as it ships.

Complete response schemas

0.1.267November 15

The OpenAPI spec now describes every field the API answers with, so generated clients get the whole payload.

Added
  • Full schemas for coins (mode, cash_payback and its basket, chain, chain_id, every link), coin and account details, platform stats, the Cash Payback rules, coins, rounds and wallets, fee recipients and keys.
  • Error lists the basket refusal fields: error.mint and error.rejected (mint, symbol, position, reason).
  • A pagination table and a launch state table in the docs.
Deprecated
  • reward_basket and basket_type on POST /launches. Send basket instead. Both still work in v1.

Cleaner error answers

0.1.266November 15
Changed
  • Error messages never include text passed through from an upstream service: links, addresses, tokens and stack traces are removed. Error code values are unchanged.
  • A request whose body is not valid JSON, or an error no endpoint handled, answers { "ok": false, "error": "..." } as JSON instead of an HTML page.
  • Responses no longer send an X-Powered-By header.

A full documentation site

0.1.265November 15

The developer docs are now a full site, and the OpenAPI spec describes every endpoint.

Added
  • Guides, principles, this changelog and an FAQ at /developers, with search.
  • An API reference page for every endpoint: parameters, request bodies, response codes, examples in cURL, JavaScript and Python, and a console to try read endpoints with your key.
  • llms.txt, llms-full.txt and every page as Markdown: add .md to its address.
  • OpenAPI: tags, operation ids, descriptions and response examples on every operation, plus the key and fee recipient endpoints (/keys, /keys/self, /keys/{id}, /fees/{mint}, /fees/batch) that were missing from the spec.

Cash Payback DEX share is 70%

0.1.263November 15
Changed
  • The Cash Payback split while a reimbursement fills is now 10% burn, 5% treasury, 70% DEX and 15% holders (was 65% and 20%). GET /payback and every coin's split carry the new numbers; holders still get 85% once the reimbursement is paid.

Launches that land late

0.1.251November 15
Added
  • 504 unconfirmed: a launch that was sent but is not confirmed yet. Submit the same launch again or read GET /launches/{id}; never create it again.
Changed
  • GET /launches/{id} stays submitting while a sent launch is unconfirmed and carries its signature, and turns expired once the chain rules it out.

Wallet shares run to the present

0.1.249November 15
Changed
  • /payback/wallets/{owner} adds each bag's time since the last holder count, so the share estimate, hold time and multiplier are current.

The registry, open read keys and faster answers

0.1.247November 15

Tell Payday coins apart from every other pump.fun coin, at volume.

Added
  • GET /registry, GET /registry/{mint} and POST /coins/check (500 mints in one request). See Which coins are Payday's.
  • Read keys without a sign-in: 3 a day per address, sharing 1,200 requests a minute, switched off after 90 days unused.
  • DELETE /keys/self: whoever holds a key can switch it off.
  • ETag on every read answer; If-None-Match gives an empty 304.
Changed
  • The fee recipient endpoints use the same keys, limits and error shape as the rest of the API, and answer non-Payday mints from memory. POST /fees/batch costs one request plus one per Payday coin.
  • /coins?sort= accepts only new, market_cap, volume and holders.

Baskets of up to 15 assets

0.1.240November 15
Changed
  • Basket launches take up to 15 assets (was 10). A launch with too many is refused with basket_size instead of being trimmed.

Fees being collected on basket coins

0.1.238November 15
Added
  • fund.being_collected_usd on basket coins: the holders' share of fees still being collected on pump.fun.

Baskets of up to 10 assets

0.1.232November 15
Changed
  • Basket launches take up to 10 assets (was 5); GET /payback reports max_assets.

Baskets on production

0.1.226November 14
Added
  • Basket fields on coins (cash_payback.basket), /coins?basket=, GET /rewards, GET /rewards/assets and the basket launch field are live.

Cash Payback baskets

0.1.225November 14
Added
  • Payout and Fund baskets: basket on POST /launches, basket details on /payback/coins/{mint} (basket, holdings, fund, dividends), and the reward list.

No launcher share on Cash Payback

0.1.195November 13
Removed
  • dev_share_pct on POST /launches. The launcher is only reimbursed for DEX.

Cash Payback endpoints

0.1.193November 13
Added
  • GET /payback, /payback/coins/{mint}, /payback/coins/{mint}/rounds/{n} and /payback/wallets/{owner}.
  • mode on every coin (account or cash_payback), and mode: "cash_payback" on POST /launches.

EVM coins and launches

0.1.188November 13
Added
  • Elysium coins in /coins and /coins/{mint}, with chain and chain_id, and a chain filter.
  • Keyed EVM launches: /evm/chains, /evm/configs, /evm/quote, /evm/launches, submit and status.

Keys work right away

0.1.157November 12
Changed
  • A key made after an X sign-in works as soon as it is made, launch keys included. No approval step; key_pending no longer happens for new keys.

Default descriptions

0.1.134November 11
Changed
  • A launch without a description says who the coin pays, for example Fees to @example via XMONEY using PAYDAY.

Zelle as a fee destination

0.1.128November 11
Added
  • fees_to: "zelle:<email or 10-digit US phone>" where Zelle is on. The email or number never appears in any response.

The launch API

0.1.127November 11
Added
  • POST /launches, POST /launches/{id}/submit, GET /launches/{id} and the fee split endpoints, for keys made with launching switched on.

Keys on every call

0.1.121November 11
Changed
  • Every data call needs a key in a header; keys in URLs are refused. 600 a minute and 250,000 a day per key.

API v1

0.1.120November 11
Added
  • /api/v1: coins, accounts, payouts, burns, stats and the OpenAPI spec.

Fee recipient API

0.1.0November 7
Added
  • GET /fees/{mint} and POST /fees/batch for trading terminals: who receives a token's creator fees, with the on-chain facts to verify it.