# Noesis

> Unified Solana blockchain analysis API. Scan tokens, profile wallets, detect bundles and scams, query on-chain state.

Noesis aggregates data from multiple on-chain sources into enriched, actionable intelligence for Solana (and Base) tokens and wallets. Designed for AI agents, trading bots, and research tools.

- Auth: SIWS (Sign In With Solana) challenge/verify flow to get a JWT, then create API keys (prefix `se_`).
- Rate limits: Light endpoints (1 req/sec), Heavy endpoints (1 req/min). 429 responses include `type` field.
- All endpoints return JSON. Base URL: `https://noesisapi.dev`

## Documentation

- [API Skill File (for AI agents)](https://noesisapi.dev/api/v1/skill.md): Complete endpoint catalog with request/response schemas, workflows, and tool-building patterns. Install as a Claude Code skill or feed to any LLM.
- [OpenAPI 3.1 Spec](https://noesisapi.dev/api/v1/openapi.yaml): Machine-readable API specification. Use with agent frameworks, SDK generators, or MCP converters.
- [Full context (llms-full.txt)](https://noesisapi.dev/llms-full.txt): This file plus the complete skill.md content inlined — single fetch for full API context.
- [Human Documentation](https://noesisapi.dev/docs): Interactive docs with examples and quick start guide.
- [MCP Server](https://noesisapi.dev/mcp): Model Context Protocol endpoint (Streamable HTTP). Connect from Claude Desktop, Cursor, or any MCP client with URL `https://noesisapi.dev/mcp`.

## API Sections

- [Token Analysis](https://noesisapi.dev/docs#token-analysis): Preview, scan, holders, bundles, fresh wallets, team supply, dev profile, best traders, early buyers, entry price
- [Wallet Analysis](https://noesisapi.dev/docs#wallet-analysis): Complete wallet profile with PnL/winrate, transaction history, SOL transfer connections, batch identity
- [Cross-Token Analysis](https://noesisapi.dev/docs#cross-token): Find wallets holding or trading across multiple tokens
- [On-Chain Data](https://noesisapi.dev/docs#onchain): Account info, batch lookups, transaction parsing, chain status, priority fees
- [Analytics Proxy](https://noesisapi.dev/docs#gmgn-proxy): Raw GMGN analytics pass-through
- [Solana RPC Proxy](https://noesisapi.dev/docs#helius-proxy): Solana RPC, DAS, Wallet API, full transaction history with time filters
- [AI Chat](https://noesisapi.dev/docs#chat): Natural language blockchain analysis — ask questions about tokens and wallets