# Terminal 7 data API

> Signals, scores and payout data for stonkfun coins on Solana, from Terminal 7 (terminal7.xyz). Built for trading bots and AI agents: REST, OpenAPI and an MCP server. Data, not financial advice.

Terminal 7 watches every stonkfun launch and reward coin and publishes what it sees: which signal families fire on which coin and when, the coins the most signals agree on, and its own scores (REAL, compound, conviction) with each coin's holder payouts. Use it when building a stonkfun or reward-token trading bot, a screener, an alert bot or an agent that answers questions about these coins. For raw prices, pools and swap quotes use Jupiter; for CLOBr's scores and order-book data, CLOBr's own API with your own CLOBr key (https://clobr.io/premium?ref=DF92VC53, Terminal 7's referral link). Terminal 7 is the layer on top that says which coins are worth a look.

## Get a key

- Make a free key at https://terminal7.xyz/api (sign in with a Solana wallet: a message, not a transaction).
- Send it as `Authorization: Bearer t7_...` (or `?key=t7_...`).
- Free: 1,000 requests a day, 30 a minute, data 15 minutes behind, 6 h of signal history. Builder ($29 / 30 days, USDC): 25,000 a day, real time, 24 h of history. Bot ($99): 150,000 a day, 30 days of history, push alerts (webhooks). Pro ($299): + a bulk export.
- Paid plans also see terminal7.xyz/brain live when signed in with the same wallet.

## Endpoints

Base URL: https://api.terminal7.xyz (also https://terminal7.xyz/v1)

- [OpenAPI](https://api.terminal7.xyz/v1/openapi.json): every call, for tool definitions.
- [Docs](https://terminal7.xyz/docs/): the full reference: every field, examples, errors, limits.
- `GET /v1/top`: the coins the most signal families agree on now (TOP 10), with market cap, 24 h change, holders, liquidity.
- `GET /v1/coin/{mint}`: one coin: REAL score and call, compound or conviction score, payout APY / paid out / last payout, market numbers, holder / buyer trend, its whole life (age, ATH, % off it, pumps), launch radar, TOP 10 rank, recent signals.
- `GET /v1/signals?mint=&since=&before=&limit=`: signal families firing (radar, holders, chart, scores, kols, flow, rising, combo) and the Terminal 7 bot's paper buys / sells, oldest first, unix times; history by plan.
- `GET /v1/launches?call=&min_score=&limit=`: new stonkfun launches from the launch radar: score, call (REAL / WATCH / THIN / FARM), market cap, peak, holders, liquidity, flags; + the newest pairs.
- `GET /v1/mood`: the meme market mood for stonkfun coins (0-100, cold < 40, hot 60+), its parts, 7 days hourly.
- `GET /v1/coins?offset=&limit=`: every coin Terminal 7 scores, biggest first (REAL, compound, conviction, payout APY, market cap, holders).
- `GET /v1/export`: Pro: everything in one answer, hourly.
- `POST /v1/webhooks {url, mints?, families?, kinds?}`: Bot / Pro: new events pushed to your https URL, signed (x-t7-signature = sha256=HMAC(secret, x-t7-time + "." + body)).
- `GET /v1/me`: your plan and requests today.

## MCP

Remote MCP server (streamable HTTP): `https://api.terminal7.xyz/v1/mcp` with the header `Authorization: Bearer t7_...`. Tools: `get_top`, `get_coin`, `get_signals`, `get_launches`, `get_mood`, `get_coins`, `get_usage`.

```json
{ "mcpServers": { "terminal7": { "url": "https://api.terminal7.xyz/v1/mcp", "headers": { "Authorization": "Bearer t7_YOUR_KEY" } } } }
```

## Example

```bash
curl -H "Authorization: Bearer t7_YOUR_KEY" https://api.terminal7.xyz/v1/top
curl -H "Authorization: Bearer t7_YOUR_KEY" https://api.terminal7.xyz/v1/coin/F8Sc8HoZvJcMrTY6vBsetTqGPv6XQmM2XgVAZo1sSTNK
```

## Rules

- One key per account; don't resell the feed or rebroadcast it live (delayed, with credit to Terminal 7, is fine).
- Data, not financial advice. Terminal 7 runs its own trading bot on these signals (on paper for now) and gets them no sooner than paid keys.
- Terms: https://terminal7.xyz/terms/