<div align="center">
Noesis
On-chain intelligence that levels the playing field.
Solana token & wallet analytics · bundle detection · fresh-wallet clustering · dev profiling · live event streams
    
Website · Docs · Get an API key · Telegram bot
</div>
---
What is Noesis?
Every 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.
Noesis 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.
Features
- 🔍 Token analysis — market metrics, security flags, top traders, holder quality
- 🧨 Bundle & sniper detection — bundler %, sniper count, fresh-wallet rate, dev holdings
- 👛 Wallet profiling — PnL, winrate, 7d/30d stats, funding source, SOL transfer graph
- 🆕 Fresh wallets — newly-created wallets holding a token, classified by age
- 🧬 Dev profiling — creator PnL, every token they've made, funding trail
- 🔗 Cross-token analysis — wallets holding or trading multiple tokens
- 📡 Live event streams — real-time SSE for PumpFun, Raydium, Meteora
- 💬 Natural-language chat — ask in plain English, answers grounded in on-chain data
- 🤖 MCP server — native integration with Claude, Cursor, Cline, Windsurf
- 📱 Telegram bot — full analysis surface in DMs or groups
Quick start
1. Get an API key
noesisapi.dev/keys — sign in with Solana, create a key.
2. Make a request
curl -H "X-API-Key: $NOESIS_API_KEY" \
"https://noesisapi.dev/api/v1/token/<MINT>/preview"3. Or use an SDK
# TypeScript / Node
npm install noesis-api
# Python
pip install noesis-api
# Rust
cargo add noesis-apiimport { Noesis } from "noesis-api";
const noesis = new Noesis({ apiKey: process.env.NOESIS_API_KEY });
const preview = await noesis.token.preview("<MINT>");
console.log(preview);MCP server
Add Noesis to any MCP-compatible client (Claude Desktop, Cursor, Cline, Windsurf):
{
"mcpServers": {
"noesis": {
"url": "https://noesisapi.dev/mcp"
}
}
}19 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.
Repository layout
| Path | Description | |---|---| | openapi.yaml | OpenAPI 3.1 specification | | sdks/typescript | TypeScript / Node.js SDK — noesis-api on npm | | sdks/python | Python SDK — noesis-api on PyPI | | sdks/rust | Rust SDK — noesis-api on crates.io | | examples/ | Runnable examples in Bash, Node, Python, and Rust | | docs/ | Guides and documentation |
API surface
| Category | Endpoints | |---|---| | Tokens | preview · scan · top-holders · bundles · fresh-wallets · team-supply · dev-profile · best-traders · early-buyers · entry-price | | Wallets | profile · history · connections · batch-identity | | Cross-analysis | cross-holders · cross-traders | | On-chain | account · accounts/batch · transactions/parse · chain/status | | Live streams (SSE) | pumpfun/new-tokens · pumpfun/migrations · raydium/new-pools · meteora/new-pools | | Chat | chat · chat/stats |
Full reference: noesisapi.dev/docs · OpenAPI spec
Rate limits
Two layers apply to every authenticated API key. Noesis is free during beta — these are abuse-prevention caps, not pricing.
1. Per-second request rate
- Light endpoints: 1 request/second
- Heavy endpoints: 1 request / 5 seconds
Exceeding 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.
2. Per-wallet daily + monthly usage cap (soft-launch — counters live, hard cap not yet enforced)
Each owner wallet has a usage budget shared across all of its API keys, so creating extra keys doesn't multiply your allowance.
- 500 units/day, 10,000 units/month per wallet
- Heavy endpoints (best-traders, top-holders, bundles, fresh-wallets, team-supply, dev-profile, early-buyers, entry-price, batch-identity, wallet/connections): 10 units each
- Light endpoints (preview, info, ticker/resolve, basic wallet): 1 unit each
- SSE streams: 0 units (no per-request cost)
- MCP requests: 10 units each (one heavy call per request)
Every API response carries headers so you can pace yourself:
X-Credits-Limit: 500
X-Credits-Used: 32
X-Credits-Remaining: 468
X-Credits-Month-Limit: 10000
X-Credits-Month-Used: 32Bypassed: signed-in web sessions (in-app at noesisapi.dev) and the Telegram bot. The cap only applies to direct API / SDK / MCP traffic.
Need more headroom? DM @Rengon0x on Telegram or X.
Status
✅ Live and actively developed · ⭐ star this repo for updates
License
Noesis is a hosted service. This repository contains landing-page content and public documentation.
The Noesis engine is closed-source. Client SDKs, examples, and the OpenAPI spec are published under the MIT License in sibling repositories.
