Skip to content

Rengon0x/NoesisAPI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Noesis

On-chain intelligence that levels the playing field.

Solana token & wallet analytics · bundle detection · fresh-wallet clustering · dev profiling · live event streams

Website API Docs OpenAPI MCP Telegram

Website · Docs · Get an API key · Telegram bot


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_bundles, token_fresh_wallets, token_top_holders, 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 · scan · 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

  • Light endpoints: 1 request/second
  • Heavy endpoints: 1 request / 5 seconds

Exceeding limits returns 429 with retry metadata.

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

About

Solana on-chain intelligence API — token scans, wallet PnL, bundle detection, fresh wallets, dev profiling. MCP server for Claude, Cursor & AI agents. Live PumpFun/Raydium streams.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors