Install

pip install noesis-api

Fully type-hinted (PEP 561) — mypy, pyright, and Pylance see the annotations out of the box.

Quick start

from noesis import Noesis

client = Noesis(api_key="se_...")

# Token preview
preview = client.token.preview("<MINT>")
print(preview)

# Wallet profile
wallet = client.wallet.profile("<ADDRESS>")
print(wallet)

# Bundle detection
bundles = client.token.bundles("<MINT>")
print(bundles)

Get an API key at noesisapi.dev/keys.

Async

AsyncNoesis mirrors the sync client. Every method is async; streams are async generators.

import asyncio
from noesis import AsyncNoesis

async def main():
    async with AsyncNoesis(api_key="se_...") as client:
        preview = await client.token.preview("<MINT>")
        print(preview)

        async for token in client.streams.pumpfun_new_tokens():
            print("New token:", token)

asyncio.run(main())

Use this inside FastAPI handlers, Jupyter cells, or any asyncio program.

Live streams

from noesis import Noesis

client = Noesis(api_key="se_...")

for token in client.streams.pumpfun_new_tokens():
    print("New token:", token)

Available streams: pumpfun_new_tokens, pumpfun_migrations, raydium_new_pools, meteora_new_pools.

API

Token

client.token.preview(mint, chain="sol")
client.token.scan(mint, chain="sol")
client.token.info(mint, chain="sol")
client.token.top_holders(mint, chain="sol")
client.token.holders(mint, chain="sol", limit=100, cursor=None)
client.token.bundles(mint)
client.token.fresh_wallets(mint)
client.token.team_supply(mint, chain="sol")
client.token.entry_price(mint, chain="sol")
client.token.dev_profile(mint, chain="sol")
client.token.best_traders(mint, chain="sol")
client.token.early_buyers(mint, hours=1, chain="sol")

Wallet

client.wallet.profile(address, chain="sol")
client.wallet.history(address, chain="sol", limit=20, type=None, source=None, before=None)
client.wallet.connections(address, min_sol=0.1, max_pages=20)
client.wallet.batch_identity(addresses)
client.wallet.cross_holders(tokens)
client.wallet.cross_traders(tokens)

Chain / on-chain

client.chain.status()
client.chain.account(address)
client.chain.accounts_batch(addresses)
client.chain.parse_transactions(signatures)

Error handling

Non-2xx responses raise a typed subclass of NoesisError:

import time
from noesis import (
    Noesis, NoesisError,
    NoesisAuthError, NoesisNotFoundError, NoesisRateLimitError,
)

client = Noesis(api_key="se_...")

try:
    client.token.preview("<MINT>")
except NoesisRateLimitError as e:
    # e.limit == "1 request/5 seconds"
    # e.limit_type == "Light" | "Heavy" | "VeryHeavy"
    # e.signed_in is a bool
    time.sleep(e.retry_after_seconds or 5)
except NoesisAuthError:
    print("Invalid or missing API key")
except NoesisNotFoundError:
    print("Wallet/token/route not found")
except NoesisError as e:
    print(e.status, e.message, e.details)

retry_after_seconds reads the JSON body and falls back to the Retry-After response header.

Context manager

with Noesis(api_key="se_...") as client:
    data = client.token.preview("<MINT>")

License

MIT — see LICENSE.

Links

• Website
• API docs
• OpenAPI spec
• Examples