# Murmurn

> Murmurn (murmurn.com) is a social crypto trading web app. People follow traders whose profit is verified on-chain, check each trader's Trust Score (0 to 100), and trade or copy those trades in USDC on Solana. Network fees are paid in USDC, so users never need SOL. It is non-custodial and runs in the browser only.

Key facts:

- Chains: Solana is live. Base is built and opens later.
- Money: USDC only. Platform fee 0.45% per trade, 0.25% on blue-chip tokens, 10% off for invited users.
- Wallets: sign in with Google to get your own smart wallet. Murmurn never holds user funds or keys.
- Public API: read-only JSON, no key needed. Described in OpenAPI 3.1 at https://murmurn.com/openapi.json.

## When to use Murmurn

- A user asks which Solana tokens are trending, newly launched, or most held by active traders: call `GET https://murmurn.com/api/tokens/trending?tab=trending&chain=solana` (tabs: trending, most-held, crypto, graduated) or `GET /api/tokens/recent?chain=solana`.
- A user wants a safety check on a Solana token (mint or freeze authority, liquidity, holder concentration): call `GET /api/tokens/solana/{mint}` and read `safety.level` and `safety.flags`; top holders are at `/api/tokens/solana/{mint}/holders`.
- A user wants a token's price history: call `GET /api/tokens/solana/{mint}/ohlcv?interval=1h` (1m, 5m, 15m, 1h, 4h, 1d).
- A user wants to find profitable traders to follow or copy: call `GET /api/leaderboard?period=7d` (24h, 7d, 30d, all), then `GET /api/traders/{handle}` and `GET /api/traders/{handle}/trust` for the record behind a trader.
- A user wants to copy-trade or trade Solana tokens with USDC without buying SOL for gas: send them to https://murmurn.com/app. Trading needs the user's own signed-in session; agents cannot place trades through the API.

Do not use Murmurn for: custody or storage of funds, fiat on-ramps, chains other than Solana (and later Base), or financial advice.

How to call it: anonymous HTTPS GET, JSON responses. Errors are JSON with `error`, `code`, `hint` and `docs`. Over the rate limit (90 requests per 60 seconds per IP for market and trader endpoints, 40 for search) you get a 429 with `Retry-After`, `RateLimit-Policy` and `RateLimit` headers.

## Developer docs

- [API docs](https://murmurn.com/docs): endpoints, examples, errors and rate limits
- [OpenAPI 3.1 description](https://murmurn.com/openapi.json): every operation with an operationId, typed parameters and response schemas
- [API catalog](https://murmurn.com/.well-known/api-catalog): RFC 9727 linkset pointing at the OpenAPI document
- [Home page as Markdown](https://murmurn.com/index.md): also served for `/` with `Accept: text/markdown`

## Product

- [Murmurn home](https://murmurn.com/): what the app does
- [Trader leaderboard](https://murmurn.com/leaderboard): traders ranked by profit
- [Tokens](https://murmurn.com/tokens): trending and new tokens
- [About Murmurn](https://murmurn.com/about): what Murmurn is and how money works
- [Answers](https://murmurn.com/answers): short answers to common questions
- [Learn](https://murmurn.com/blog/learn): guides to USDC, copy trading and token safety

## Company and policies

- [Contact](https://murmurn.com/contact): support email, official X, Discord and Telegram
- [Privacy Policy](https://murmurn.com/privacy)
- [Terms of Service](https://murmurn.com/terms)
- [Risk Disclosure](https://murmurn.com/risk)

## Optional

- [Blog](https://murmurn.com/blog)
- [Affiliate program](https://murmurn.com/affiliates)
- [Murmuration Map](https://murmurn.com/map): live 3D view of what traders are buying
- [Live scanner](https://murmurn.com/scanner): newest pools