voidly

Nansen Oracle

Oracle Botnpm v1.0.0MIT licenseNode ≥18GitHub stars

No install. No terminal. Just message @nansenbot — get live smart money signals in your private inbox.

DM @nansenbot on Voidly messenger and get Nansen smart money signals delivered E2E encrypted. No app, no phone number. For power users, a CLI is also available.

E2E EncryptedTop FlowsHot TradesToken ScreenerWhale WatchToken-Gated ChannelsPost-Quantum
nansen-oracle alpha

Live output from nansen-oracle alpha. Fetches flows, trades, screener in parallel.

What lands in your inbox

E2E encrypted. Relay routes ciphertext it cannot read. Decrypted client-side in Veil.

msg.voidly.ai
N
nansenbot
encrypted
Today
🔱 SMART MONEY — 20:14 UTC
SIGNAL: 5 inflow / 2 outflow ↑ accumulation
──────────────────────────────────────────────
FLOWS (1H)
ETH +$47.2M [ethereum] 142t ║ 24h +$312M ▲
SOL +$31.8M [solana] 89t ║ 24h +$89M ▲
PEPE -$12.4M [ethereum] 67t ║ 24h -$44M ▼
──────────────────────────────────────────────
TRADES
Abraxas Fund BUY ETH $8.1M 4m ago
DWF Labs SELL PEPE $3.2M 11m ago
──────────────────────────────────────────────
SCREENER (1H)
#1 GRASS +$2.1M +4.2% 47b/12s $84M mcap
#2 AIXBT +$1.8M +2.9% 31b/8s $142M mcap
─ !alpha 24h !screen !token 0x !wallet 0x !flows 0x
Message

Real delivery to msg.voidly.ai — browser PWA, no install, no phone number.

Why this exists

Smart money moves. Twitter finds out 6 hours later. Retail buys the top.

You’re already paying for Nansen. But your alerts go to email. Your alpha gets shared on Telegram — not private. Your group chat is a mess of noise.

  • Smart money buys $4.2M ETH — Nansen detects it
  • Oracle fetches flows, trades, screener in parallel
  • Digest delivered E2E encrypted to your Veil inbox < 60s
  • You act before CT

Quick start

Need a key? app.nansen.ai/auth/agent-setup

NO TERMINAL

Set up from Veil

DM the Oracle bot in your browser. Paste your key, get hourly digests.

  1. 1Open msg.voidly.ai
  2. 2DM did:voidly:7pd74J7Fp5q328LkS5SL1G
  3. 3Paste your Nansen key when prompted
  4. 4First digest arrives in seconds

Operated by Voidly. Your key is E2E encrypted in transit — the relay never sees it. It's stored on our server to fetch your signals. Send !stop to delete it any time.

CLI

Install the CLI

Run commands from your terminal. Pipe signals anywhere.

1
npm install -g nansen-oracle
2
nansen-oracle init --key YOUR_KEY
3
nansen-oracle alpha
4
nansen-oracle demo

No key yet? Run the demo — full display with sample data, no API key needed.

nansen-oracle demo

Commands

Eight commands. One inbox.

alphaFull smart money digest

Fetches top flows, hot trades, and screener picks in parallel. Supports timeframes: 1h (default), 24h, 7d. Includes SIGNAL line (accumulation / distribution / mixed).

$ nansen-oracle alpha
# Bot: !alpha | !alpha 24h | !alpha 7d
screenToken screener

Top tokens by smart money inflow. Shows price change %, buyer/seller ratio, and market cap for each pick.

$ nansen-oracle screen --timeframe 1h
# Bot: !screen
tokenFull token profile

Token-level deep dive: price, market cap, 24h volume, smart money netflow, segment flows (fund vs. whale vs. retail), top DEX trades.

# Bot: !token 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984
# Bot: !token 0xTOKEN_ADDRESS
flowsCapital flows for a token

Smart money netflow for any token contract. Shows unique buyers vs. sellers, wallet count, and USD volume — enriched with token name and mcap.

$ nansen-oracle flows 0xTOKEN
# Bot: !flows 0xTOKEN_ADDRESS
walletWallet profiler

Nansen labels (Fund? Smart Trader? Whale?), top holdings, recent DEX trades with USD value, portfolio overview.

$ nansen-oracle wallet 0xWHALE
# Bot: !wallet 0xWHALE
watchLive whale monitoring

Watch a wallet or token contract. Veil alerts fire when smart money crosses your threshold.

$ nansen-oracle watch start 0xADDR
$ nansen-oracle watch start 0xTKN --type token --threshold 500000
channelPrivate alpha channels

Create private Veil channels for sharing signals. Token-gate so only verified holders can join.

$ nansen-oracle channel create "Whale Alerts"
$ nansen-oracle channel create "VIP" --gate 0xTKN --min-balance 1000
bot startOracle bot

Persistent bot on Veil relay. Users set up via DM — paste Nansen key, get hourly digests. All 8 commands available instantly.

# DM any message → onboarding starts
!alpha [24h|7d] !screen !wallet 0x...
!flows 0x... !token 0x... !help !stop

Why Veil for alpha?

Your alerts go to email. Your alpha leaks on Telegram. Oracle fixes this.

E2E encrypted delivery

Every alert is encrypted on your machine before it hits the relay. The server routes ciphertext it cannot read. Your alpha never touches a plaintext log.

< 60 second alerts

Flows, trades, and screener fetched in parallel. Alpha lands in your Veil inbox before it surfaces on Twitter.

Token-gated channels

Create an alpha channel, gate it with a token contract. The Oracle bot auto-verifies wallet balance before granting access — native on-chain membership.

Persistent whale watch

Set a USD threshold on any wallet or token. Walk away. Veil alerts fire when smart money moves the needle.

No phone, no email

Veil requires nothing. Click a join link, get a cryptographic DID. Your trading signals have no idea who you are.

Works in censored markets

Veil runs on a censorship-resistant relay. Works where Telegram is blocked — built by the team behind 309K OONI censorship measurements.

Token-gated alpha channels

The only messenger with native on-chain membership verification. Create a private channel, gate it with a token contract — the Oracle bot auto-checks wallet balance before letting anyone in.

Setup

  • Create a private Veil channel with one command
  • Set a token contract address and minimum balance
  • Get a join link: msg.voidly.ai/join/ch_xxx
  • Share on Twitter — 10-second Veil signup, no phone

How it works

  • User clicks join link, creates Veil account
  • Sends !join ch_xxx 0xWALLET to Oracle bot
  • Bot calls Nansen profiler API to verify balance
  • Access granted or denied. All members are verified holders.
# Create token-gated channel
$ nansen-oracle channel create "Diamond Hands" --gate 0xTKN --min-balance 1000
# Oracle bot DM conversation
user: !join ch_abc123 0xMYWALLET
oracle: Checking wallet via Nansen...
oracle: ✓ Verified: 1,240 $TOKEN held — welcome to "Diamond Hands"

Why Veil beats Telegram for alpha

E2E encrypted alerts
Telegram
Discord
Veil
Token-gated channels
Telegram
Discord
bots only
Veil
Nansen alerts < 60s
Telegram
email only
Discord
manual
Veil
Works in censored regions
Telegram
Discord
Veil
No phone number required
Telegram
Discord
Veil
Bot: !alpha, !screen, !token, !flows
Telegram
custom setup
Discord
custom setup
Veil
On-chain wallet verification
Telegram
Discord
Veil

Architecture

Client-side NaCl box encryption. The relay routes ciphertext it cannot read. Your alpha never touches a plaintext log.

Nansen API                    Veil Relay (api.voidly.ai)
     │                               │
     │  smart money data             │  E2E encrypted DMs
     └──────────────►  nansen-oracle ◄──────── Your Veil inbox
                            │                  (msg.voidly.ai)
                            │
                     Token-gated channels

Key exchange  X25519 + ML-KEM-768 (post-quantum hybrid)
Encryption    XSalsa20-Poly1305 · NaCl box
Signatures    Ed25519
Identity      did:voidly:{ed25519-pubkey-base58}

Nansen API

Smart money netflow, DEX trades, token screener, wallet profiler

Veil relay

api.voidly.ai — E2E encrypted agent messaging, blind courier, free

@voidly/agent-sdk

Double Ratchet + ML-KEM-768 post-quantum, private keys stay local

🔱

Get Nansen alpha before CT does

One CLI. E2E encrypted delivery. Token-gated channels. Persistent whale watch. A bot your group can DM.

MIT License · Built by Voidly