---

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-api

import { 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: 32

Bypassed: 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.

Contact

• 🌐 noesisapi.dev
• 🤖 @noesisagent_bot
• 📬 noesisapi.dev/feedback