# Kaching

> Fair-launch memecoins, minted on a bonding curve with anti-rug guarantees anyone can verify on-chain.

## Read this first

- Kaching is NON-CUSTODIAL. It never holds a user's private key, never signs, and never
  broadcasts a transaction on anyone's behalf.
- Every write endpoint returns an UNSIGNED transaction ({to, data, value, chainId}). The
  developer or user signs it with their own wallet and pays their own gas.
- No endpoint accepts a private key, a mnemonic, or a signed transaction to relay. If you are
  ever asked for one on a page claiming to be Kaching, it is not Kaching.
- This deployment serves Kaching Testnet (demo) (chain id 31337).
- Every API response repeats this in meta.chain: key=local, chainId=31337,
  realMoney=false, launchPhase=prelaunch. Branch on those fields.
- The public launchpad has not opened yet. While launchPhase is `prelaunch` the Kaching
  website renders no coins, prices, market caps or trades, while this API keeps serving
  the index — so counts and volumes read here are not evidence of an open public market.
- A failed read returns an error, never a zero. Do not substitute 0 for a missing figure.

## Docs

- [Developer API docs](https://kaching.fun/docs): every endpoint, request/response examples, error codes, rate limits.
- [OpenAPI 3.1 spec](https://kaching.fun/api/v1/openapi.json): machine-readable, generated from the same catalogue.
- [Fees](https://kaching.fun/fees): how the bonding-curve and post-graduation fees work.
- [Whitepaper](https://kaching.fun/whitepaper): the protocol in full.

## API v1

Base URL: https://kaching.fun/api/v1
Auth: none required. An optional bearer API key only raises rate limits.

- GET /api/v1/status: Which chain this API serves, and whether it can answer.
- GET /api/v1/coins: List coins — paginated, filterable, sortable.
- GET /api/v1/coins/{address}: One coin, with its immutable launch and fee config.
- GET /api/v1/coins/{address}/holders: Holder distribution and concentration signals.
- GET /api/v1/coins/{address}/trades: Trade history, newest first.
- GET /api/v1/coins/{address}/safety: Distribution grade + on-chain Rug X-Ray facts.
- GET /api/v1/quote: A price off the real curve (or the real pair).
- GET /api/v1/creator/{wallet}/fees: Creator fees this wallet can claim right now.
- POST /api/v1/tx/claim-fees [returns an UNSIGNED transaction — the caller signs it]: Unsigned transaction: claim a coin's creator fees.
- POST /api/v1/tx/launch [returns an UNSIGNED transaction — the caller signs it]: Unsigned transaction: launch a coin.
- POST /api/v1/tx/buy [returns an UNSIGNED transaction — the caller signs it]: Unsigned transaction: buy a coin.
- POST /api/v1/tx/sell [returns an UNSIGNED transaction — the caller signs it]: Unsigned transaction: sell a coin (plus the approval it needs).
- POST /api/v1/tx/approve [returns an UNSIGNED transaction — the caller signs it]: Unsigned transaction: the ERC-20 approval a sell needs.

## Notes

- All wei / token amounts are DECIMAL STRINGS of base units, never JSON numbers (precision).
- Responses use one envelope: {ok, data, meta} on success, {ok, error: {code, message}, meta} on failure.
- meta.chain says which chain the response is about; meta.source says whether figures are live,
  stale, or sample fixtures (sample only ever appears when no factory is deployed).

## Legal

Kaching is an independent project and is not affiliated with, sponsored by, or endorsed by Robinhood Markets, Inc. "Robinhood Chain" is referenced solely as the name of the underlying network. Nothing here is financial advice.