{
"markdown": "\n\n# Noesis\n\n**On-chain intelligence that levels the playing field.**\n\nSolana token & wallet analytics · bundle detection · fresh-wallet clustering · dev profiling · live event streams\n\n[](https://noesisapi.dev)\n[](https://noesisapi.dev/docs)\n[](https://github.com/Rengon0x/NoesisAPI/blob/main/openapi.yaml)\n[](https://noesisapi.dev/mcp)\n[](https://t.me/noesisagent_bot)\n\n[**Website**](https://noesisapi.dev) · [**Docs**](https://noesisapi.dev/docs) · [**Get an API key**](https://noesisapi.dev/keys) · [**Telegram bot**](https://t.me/noesisagent_bot)\n\n
\n\n---\n\n## What is Noesis?\n\nEvery rug, every insider pump, every bundled launch leaves a trail. Most traders never see it — the tools are fragmented, expensive, or locked behind UIs that don't integrate with how people actually work.\n\nNoesis collapses that into a single agent-native surface: one API, one MCP server, one chat. Built for traders, researchers, and AI agents that would rather see than guess.\n\n## Features\n\n- 🔍 **Token analysis** — market metrics, security flags, top traders, holder quality\n- 🧨 **Bundle & sniper detection** — bundler %, sniper count, fresh-wallet rate, dev holdings\n- 👛 **Wallet profiling** — PnL, winrate, 7d/30d stats, funding source, SOL transfer graph\n- 🆕 **Fresh wallets** — newly-created wallets holding a token, classified by age\n- 🧬 **Dev profiling** — creator PnL, every token they've made, funding trail\n- 🔗 **Cross-token analysis** — wallets holding or trading multiple tokens\n- 📡 **Live event streams** — real-time SSE for PumpFun, Raydium, Meteora\n- 💬 **Natural-language chat** — ask in plain English, answers grounded in on-chain data\n- 🤖 **MCP server** — native integration with Claude, Cursor, Cline, Windsurf\n- 📱 **Telegram bot** — full analysis surface in DMs or groups\n\n## Quick start\n\n### 1. Get an API key\n\n[noesisapi.dev/keys](https://noesisapi.dev/keys) — sign in with Solana, create a key.\n\n### 2. Make a request\n\n```bash\ncurl -H \"X-API-Key: $NOESIS_API_KEY\" \\\n \"https://noesisapi.dev/api/v1/token//preview\"\n```\n\n### 3. Or use an SDK\n\n```bash\n# TypeScript / Node\nnpm install noesis-api\n\n# Python\npip install noesis-api\n\n# Rust\ncargo add noesis-api\n```\n\n```typescript\nimport { Noesis } from \"noesis-api\";\n\nconst noesis = new Noesis({ apiKey: process.env.NOESIS_API_KEY });\nconst preview = await noesis.token.preview(\"\");\nconsole.log(preview);\n```\n\n## MCP server\n\nAdd Noesis to any MCP-compatible client (Claude Desktop, Cursor, Cline, Windsurf):\n\n```json\n{\n \"mcpServers\": {\n \"noesis\": {\n \"url\": \"https://noesisapi.dev/mcp\"\n }\n }\n}\n```\n\n19 tools available — token analysis (`token_scan`, `token_preview`, `token_info`, `token_holders`, `token_top_holders`, `token_bundles`, `token_fresh_wallets`, `token_team_supply`, `token_entry_price`, `token_dev_profile`, `token_best_traders`, `token_early_buyers`), wallet analysis (`wallet_profile`, `wallet_connections`, `wallet_history`), cross-token (`cross_holders`, `cross_traders`), and on-chain (`chain_status`, `transactions_parse`). See [full list](https://noesisapi.dev/docs).\n\n## Repository layout\n\n| Path | Description |\n|---|---|\n| [`openapi.yaml`](./openapi.yaml) | OpenAPI 3.1 specification |\n| [`sdks/typescript`](./sdks/typescript) | TypeScript / Node.js SDK — [`noesis-api`](https://www.npmjs.com/package/noesis-api) on npm |\n| [`sdks/python`](./sdks/python) | Python SDK — [`noesis-api`](https://pypi.org/project/noesis-api/) on PyPI |\n| [`sdks/rust`](./sdks/rust) | Rust SDK — [`noesis-api`](https://crates.io/crates/noesis-api) on crates.io |\n| [`examples/`](./examples) | Runnable examples in Bash, Node, Python, and Rust |\n| [`docs/`](./docs) | Guides and documentation |\n\n## API surface\n\n| Category | Endpoints |\n|---|---|\n| **Tokens** | preview · scan · top-holders · bundles · fresh-wallets · team-supply · dev-profile · best-traders · early-buyers · entry-price |\n| **Wallets** | profile · history · connections · batch-identity |\n| **Cross-analysis** | cross-holders · cross-traders |\n| **On-chain** | account · accounts/batch · transactions/parse · chain/status |\n| **Live streams (SSE)** | pumpfun/new-tokens · pumpfun/migrations · raydium/new-pools · meteora/new-pools |\n| **Chat** | chat · chat/stats |\n\nFull reference: [noesisapi.dev/docs](https://noesisapi.dev/docs) · [OpenAPI spec](https://noesisapi.dev/api/v1/openapi.yaml)\n\n## Rate limits\n\nTwo layers apply to every authenticated API key. Noesis is free during beta — these are abuse-prevention caps, not pricing.\n\n**1. Per-second request rate**\n\n- **Light** endpoints: 1 request/second\n- **Heavy** endpoints: 1 request / 5 seconds\n\nExceeding returns `429` with a `Retry-After` header and a JSON body: `{error, limit, type, retry_after_seconds, signed_in}`. All three SDKs surface this as a typed rate-limit error with `retry_after_seconds` as a first-class field.\n\n**2. Per-wallet daily + monthly usage cap** *(soft-launch — counters live, hard cap not yet enforced)*\n\nEach owner wallet has a usage budget shared across all of its API keys, so creating extra keys doesn't multiply your allowance.\n\n- **500 units/day, 10,000 units/month** per wallet\n- **Heavy** endpoints (best-traders, top-holders, bundles, fresh-wallets, team-supply, dev-profile, early-buyers, entry-price, batch-identity, wallet/connections): **10 units** each\n- **Light** endpoints (preview, info, ticker/resolve, basic wallet): **1 unit** each\n- **SSE streams**: **0 units** (no per-request cost)\n- **MCP requests**: **10 units** each (one heavy call per request)\n\nEvery API response carries headers so you can pace yourself:\n\n```\nX-Credits-Limit: 500\nX-Credits-Used: 32\nX-Credits-Remaining: 468\nX-Credits-Month-Limit: 10000\nX-Credits-Month-Used: 32\n```\n\n**Bypassed**: signed-in web sessions (in-app at noesisapi.dev) and the Telegram bot. The cap only applies to direct API / SDK / MCP traffic.\n\nNeed more headroom? DM [@Rengon0x](https://t.me/Rengon0x) on Telegram or X.\n\n## Status\n\n✅ Live and actively developed · ⭐ star this repo for updates\n\n## License\n\nNoesis is a hosted service. This repository contains landing-page content and public documentation.\n\nThe Noesis engine is closed-source. Client SDKs, examples, and the OpenAPI spec are published under the MIT License in sibling repositories.\n\n## Contact\n\n- 🌐 [noesisapi.dev](https://noesisapi.dev)\n- 🤖 [@noesisagent_bot](https://t.me/noesisagent_bot)\n- 📬 [noesisapi.dev/feedback](https://noesisapi.dev/feedback)\n",
"bytes": 6783,
"sha": "97dfd4ac6d5b2a5c9bbc3da117959869474754b127aa70164f122cc488e20d4c",
"repo_slug": "rengon0x/noesisapi",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/mcp_io_github_rengon0x_noesis_3fa9a325/readme"
}