# Payday API

> Read Payday coins, the accounts they pay, holder rewards and burns, and launch Payday coins, from any app, bot or terminal.

Base URL: https://payday.direct/api/v1. OpenAPI: https://payday.direct/api/v1/openapi.json.

## Get started

- [Introduction](https://payday.direct/developers/index.md): Read Payday coins, the accounts they pay, holder rewards and burns, and launch Payday coins, from any app, bot or terminal.
- [Quickstart](https://payday.direct/developers/quickstart.md): Make a key, call the API and read your first coin.
- [Authentication](https://payday.direct/developers/authentication.md): Every call carries an API key in a header.
- [API keys](https://payday.direct/developers/api-keys.md): Make, list and revoke your keys.

## Principles

- [Base URL and versioning](https://payday.direct/developers/principles/versioning.md): One base URL; v1 only gains fields.
- [Responses and numbers](https://payday.direct/developers/principles/responses.md): The envelope, money as strings, times in UTC.
- [Pagination](https://payday.direct/developers/principles/pagination.md): Cursors for lists; the registry follows its own cursor.
- [Freshness and caching](https://payday.direct/developers/principles/caching.md): A 15 second snapshot, ETags and 304s.
- [Errors](https://payday.direct/developers/principles/errors.md): One error shape, stable codes, what to retry.
- [Rate limits](https://payday.direct/developers/principles/rate-limits.md): Per key, per day, per address and per launch.
- [Privacy and opt-outs](https://payday.direct/developers/principles/privacy.md): What the API shows about people, and what it never shows.

## Guides

- [Which coins are Payday's](https://payday.direct/developers/guides/registry.md): Follow the registry and check mints in bulk.
- [Show who gets a coin's fees](https://payday.direct/developers/guides/fee-recipient.md): For trading terminals: the fee recipient of any token, verifiable on chain.
- [Track an account's payouts](https://payday.direct/developers/guides/accounts.md): What an X account earned, was paid, and what is on the way.
- [Read Cash Payback rounds](https://payday.direct/developers/guides/cash-payback.md): A coin's pot and rounds, one round's payments, and a wallet's rewards.
- [Launch a coin on Solana](https://payday.direct/developers/guides/launch-solana.md): Build, sign and submit a Payday launch from your app.
- [Launch a Cash Payback or basket coin](https://payday.direct/developers/guides/launch-cash-payback.md): Fees to the coin's holders, in the pairing or a basket of assets.
- [Launch a coin on EVM](https://payday.direct/developers/guides/launch-evm.md): Elysium through Montra: your wallet sends the launch itself.

## API reference

- [GET /coins: List coins](https://payday.direct/developers/api-reference/coins/list-coins.md)
- [GET /coins/{mint}: Get a coin](https://payday.direct/developers/api-reference/coins/get-a-coin.md)
- [GET /registry: Follow the registry](https://payday.direct/developers/api-reference/registry/follow-the-registry.md)
- [GET /registry/{mint}: Check one mint](https://payday.direct/developers/api-reference/registry/check-one-mint.md)
- [POST /coins/check: Check mints in bulk](https://payday.direct/developers/api-reference/registry/check-mints-in-bulk.md)
- [GET /fees/{mint}: Get a fee recipient](https://payday.direct/developers/api-reference/fee-recipients/get-a-fee-recipient.md)
- [POST /fees/batch: Get fee recipients in bulk](https://payday.direct/developers/api-reference/fee-recipients/get-fee-recipients-in-bulk.md)
- [GET /accounts: List accounts](https://payday.direct/developers/api-reference/accounts-and-payouts/list-accounts.md)
- [GET /accounts/{handle}: Get an account](https://payday.direct/developers/api-reference/accounts-and-payouts/get-an-account.md)
- [GET /payouts: List payouts](https://payday.direct/developers/api-reference/accounts-and-payouts/list-payouts.md)
- [GET /payback: Get the rules](https://payday.direct/developers/api-reference/cash-payback/get-the-rules.md)
- [GET /payback/coins/{mint}: Get a Cash Payback coin](https://payday.direct/developers/api-reference/cash-payback/get-a-cash-payback-coin.md)
- [GET /payback/coins/{mint}/rounds/{n}: Get a round](https://payday.direct/developers/api-reference/cash-payback/get-a-round.md)
- [GET /payback/wallets/{owner}: Get a wallet's rewards](https://payday.direct/developers/api-reference/cash-payback/get-a-wallets-rewards.md)
- [GET /rewards: Get holder rewards](https://payday.direct/developers/api-reference/holder-rewards/get-holder-rewards.md)
- [GET /rewards/assets: List basket assets](https://payday.direct/developers/api-reference/holder-rewards/list-basket-assets.md)
- [GET /burns: List Payday token burns](https://payday.direct/developers/api-reference/platform/list-payday-token-burns.md)
- [GET /stats: Get platform totals](https://payday.direct/developers/api-reference/platform/get-platform-totals.md)
- [POST /launches: Create a launch](https://payday.direct/developers/api-reference/launch-on-solana/create-a-launch.md)
- [GET /launches/{id}: Get a launch](https://payday.direct/developers/api-reference/launch-on-solana/get-a-launch.md)
- [POST /launches/{id}/submit: Submit a launch](https://payday.direct/developers/api-reference/launch-on-solana/submit-a-launch.md)
- [POST /launches/{id}/split: Get fresh fee split transactions](https://payday.direct/developers/api-reference/launch-on-solana/get-fresh-fee-split-transactions.md)
- [POST /launches/{id}/split/confirm: Confirm the fee split](https://payday.direct/developers/api-reference/launch-on-solana/confirm-the-fee-split.md)
- [GET /evm/chains: List EVM chains](https://payday.direct/developers/api-reference/launch-on-evm/list-evm-chains.md)
- [GET /evm/configs: List pairings](https://payday.direct/developers/api-reference/launch-on-evm/list-pairings.md)
- [POST /evm/quote: Quote a launch](https://payday.direct/developers/api-reference/launch-on-evm/quote-a-launch.md)
- [POST /evm/launches: Create an EVM launch](https://payday.direct/developers/api-reference/launch-on-evm/create-an-evm-launch.md)
- [POST /evm/launches/{id}/submit: Submit an EVM launch](https://payday.direct/developers/api-reference/launch-on-evm/submit-an-evm-launch.md)
- [GET /evm/launches/{id}: Get an EVM launch](https://payday.direct/developers/api-reference/launch-on-evm/get-an-evm-launch.md)
- [GET /keys: List your keys](https://payday.direct/developers/api-reference/keys/list-your-keys.md)
- [POST /keys: Create a key](https://payday.direct/developers/api-reference/keys/create-a-key.md)
- [DELETE /keys/self: Revoke this key](https://payday.direct/developers/api-reference/keys/revoke-this-key.md)
- [DELETE /keys/{id}: Revoke a key by id](https://payday.direct/developers/api-reference/keys/revoke-a-key-by-id.md)
- [GET /openapi.json: Get the OpenAPI spec](https://payday.direct/developers/api-reference/keys/get-the-openapi-spec.md)

## Changelog

- [Changelog](https://payday.direct/developers/changelog.md): Every change to the API, newest first.

## FAQ

- [FAQ](https://payday.direct/developers/faq.md): Short answers to common questions.