# 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](/developers/guides/otc).

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](https://t.me/paydayann).

## API updates on Telegram

0.1.268November 15

Added

- A Telegram channel for API updates, [t.me/paydayann](https://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](/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](/developers/llms.txt), [llms-full.txt](/developers/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](/developers/guides/registry).
- 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:"` 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.
