robinhood-chain-x402 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MadeOnSol
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,135 @@
+# robinhood-chain-x402
+
+[![npm version](https://img.shields.io/npm/v/robinhood-chain-x402?style=flat-square)](https://www.npmjs.com/package/robinhood-chain-x402)
+[![npm downloads](https://img.shields.io/npm/dm/robinhood-chain-x402?style=flat-square)](https://www.npmjs.com/package/robinhood-chain-x402)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5+-blue?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue?style=flat-square)](LICENSE)
+
+> 📂 **[Examples](./examples/)** · 📚 **[API docs](https://madeonsol.com/api-docs)** · 🤖 **[Robinhood Chain](https://madeonsol.com/robinhood)** · 💰 **[Free API key](https://madeonsol.com/pricing)**
+
+**TypeScript SDK for the [MadeOnSol](https://madeonsol.com/robinhood) Robinhood Chain API — EVM-native on-chain trading intelligence for Robinhood Chain, chain id 4663.**
+
+Robinhood Chain is an Arbitrum Orbit L2. This SDK gives you the same intel you get on Solana — live KOL trades, a DEX trade tape, token discovery, launch-bundle detection, early-buyer quality, deployer reputation and smart-money wallets — but EVM-native: lowercase `0x` addresses, `eth_amount`, `tx_hash`, `block_number`, `net_flow_eth`. Data comes from our **self-hosted RHC node**. The KOL→EVM mapping is recovered by tracing each Solana KOL's bridge deposits (deBridge / Relay / Mayan / Wormhole) — a dataset unique to MadeOnSol.
+
+RHC coverage is **bundled into every tier at no extra cost** — same API key, same base URL. Get a free key (200 req/day, no card) at [madeonsol.com/pricing](https://madeonsol.com/pricing).
+
+> **Key-mode only.** This package authenticates with an `msk_` Bearer API key. The x402 pay-per-call micropayment rail is Solana-native and is **not** ported here — for keyless USDC-per-call on the Solana API, use [`madeonsol-x402`](https://www.npmjs.com/package/madeonsol-x402).
+
+## Install
+
+```bash
+npm install robinhood-chain-x402
+```
+
+> Zero required runtime dependencies. The live stream will use the optional [`ws`](https://www.npmjs.com/package/ws) package on Node when present (recommended on Node ≥ 22 for a clean process exit); the browser uses the native `WebSocket`.
+
+## Quick start (10 seconds)
+
+```ts
+import { createClient } from "robinhood-chain-x402";
+
+const client = createClient("msk_your_api_key_here"); // free tier at madeonsol.com/pricing
+
+// Live KOL buys/sells on Robinhood Chain (chain id 4663)
+const { trades } = await client.kolFeed({ limit: 10, action: "buy" });
+console.log(trades);
+```
+
+### Advanced initialization
+
+```ts
+import { RobinhoodChainX402 } from "robinhood-chain-x402";
+
+const client = new RobinhoodChainX402({
+  apiKey: "msk_...",
+  baseUrl: "https://madeonsol.com", // optional override
+});
+```
+
+## Endpoints — all 14 Robinhood Chain routes
+
+Every method maps 1:1 to a GET /api/v1/rhc/… route. Fields are EVM-native.
+
+### KOL intelligence
+
+| Method | Route | Tier | Description |
+|---|---|---|---|
+| `kolFeed(params?)` | `/api/v1/rhc/kol/feed` | BASIC | Real-time KOL trade feed — every buy/sell from tracked KOLs' verified EVM wallets, enriched with MC/peak and `mc_multiple_since_trade` |
+| `kolLeaderboard(params?)` | `/api/v1/rhc/kol/leaderboard` | BASIC | KOLs ranked by trade count then net ETH flow over `24h`/`7d`/`30d` |
+| `kolHotTokens(params?)` | `/api/v1/rhc/kol/hot-tokens` | BASIC | Consensus tokens bought by 2+ distinct KOLs in the window |
+| `kol(wallet)` | `/api/v1/rhc/kol/{wallet}` | BASIC | Single KOL profile — aggregate stats + 50 most recent trades |
+
+### DEX trade tape
+
+| Method | Route | Tier | Description |
+|---|---|---|---|
+| `trades(params?)` | `/api/v1/rhc/trades` | PRO+ | Every Uniswap v2/v3/v4 swap with the real `trader_eoa`, gas/ordering for MEV, and KOL/deployer flags |
+
+### Token discovery + intelligence
+
+| Method | Route | Tier | Description |
+|---|---|---|---|
+| `tokens(params?)` | `/api/v1/rhc/tokens` | PRO+ | Live-priced token discovery — MC, liquidity, peak MC + drawdown, launchpad, deployer tier |
+| `token(address)` | `/api/v1/rhc/tokens/{address}` | BASIC | Full token snapshot — price/MC/FDV, graduation, deployer block, KOL activity, pools |
+| `tokenCandles(address, params?)` | `/api/v1/rhc/tokens/{address}/candles` | PRO+ | 1-minute OHLC candles — price + MC OHLC, close liquidity, volume with buy/sell split |
+| `tokenKolConsensus(address)` | `/api/v1/rhc/tokens/{address}/kol-consensus` | PRO+ | KOL positioning — buyers vs sellers, exit rate, `net_flow_eth`, median entry MC (ULTRA adds wallet lists) |
+| `tokenBuyerQuality(address)` | `/api/v1/rhc/tokens/{address}/buyer-quality` | BASIC | 0–100 early-buyer quality with bundle-buyer + dump-cluster legs |
+| `tokenBundle(address)` | `/api/v1/rhc/tokens/{address}/bundle` | BASIC | Launch-bundle detection (`same_block`) + how much the cohort still holds |
+
+### Deployer hunter + smart money
+
+| Method | Route | Tier | Description |
+|---|---|---|---|
+| `deployerLeaderboard(params?)` | `/api/v1/rhc/deployer-hunter/leaderboard` | BASIC | Deployers ranked by reputation — `graduation_rate` ($40K+ peak MC), `runner_rate` ($100K+) |
+| `deployer(address)` | `/api/v1/rhc/deployer-hunter/{address}` | BASIC | Single deployer profile + 50 most recent tokens (unknown wallets → `is_deployer: false`) |
+| `alphaWallets(params?)` | `/api/v1/rhc/alpha-wallets` | PRO+ | Smart-money wallets ranked by realized performance — `net_eth`, `win_rate`, `memecoin_share`, `likely_bot` |
+
+### Examples
+
+```ts
+// Deployer reputation leaderboard — elite deployers first
+const { deployers } = await client.deployerLeaderboard({ sort: "runner_rate", tier: "elite" });
+
+// Is this token's early cohort a launch bundle that's still holding?
+const { bundle } = await client.tokenBundle("0xToken...");
+console.log(bundle.bundle_kind, bundle.held_pct_of_supply);
+
+// Smart-money memecoin traders only, biggest net ETH first
+const { wallets } = await client.alphaWallets({ classification: "smart_money", min_memecoin_share: 0.7 });
+```
+
+## Streaming
+
+Managed WebSocket stream over ws-streaming (`wss://madeonsol.com/stream`). Handles the token fetch + 24h refresh, auto-reconnect with backoff, and heartbeat liveness. Two RHC channels: `rhc:kol_trades` (the KOL tape) and `rhc:trades` (the full DEX firehose). PRO/ULTRA.
+
+```ts
+const stream = client.stream();
+
+stream.on("rhc:kol_trade", (t) => console.log("KOL trade", t));
+stream.on("rhc:trade", (t) => console.log("DEX trade", t));
+stream.on("open", () => console.log("connected to chain 4663"));
+
+stream.subscribe(["rhc:kol_trades", "rhc:trades"]);
+
+// later
+stream.close();
+```
+
+## Rate limits
+
+Every successful response updates `client.lastRateLimit` from the `X-RateLimit-*` headers:
+
+```ts
+await client.kolFeed({ limit: 5 });
+console.log(client.lastRateLimit); // { limit, remaining, reset, requestId }
+```
+
+## Links
+
+- 🤖 Robinhood Chain overview — https://madeonsol.com/robinhood
+- 💰 Pricing & free API key — https://madeonsol.com/pricing
+- 📚 API docs — https://madeonsol.com/api-docs
+
+## License
+
+MIT © MadeOnSol

package/dist/index.d.ts

@@ -0,0 +1,154 @@
+/**
+ * robinhood-chain-x402 — TypeScript client for the MadeOnSol Robinhood Chain
+ * (chain id 4663) API.
+ *
+ * Robinhood Chain is an Arbitrum Orbit L2. This package is **key-mode only**:
+ * it authenticates with an `msk_` Bearer API key against the Robinhood Chain
+ * (/api/v1/rhc/…) endpoints. The x402 pay-per-call rail is Solana-native and is NOT ported here
+ * — see the Solana `madeonsol-x402` package for on-chain USDC micropayments.
+ *
+ * Get a free API key (200 req/day, no card) at https://madeonsol.com/pricing —
+ * RHC coverage is bundled into every tier at no extra cost.
+ */
+import type { KolFeedParams, KolFeedResponse, KolLeaderboardParams, KolLeaderboardResponse, KolHotTokensParams, KolHotTokensResponse, RhcKolProfileResponse, TradesParams, TradesResponse, TokensParams, TokensResponse, RhcTokenDetailResponse, CandlesParams, CandlesResponse, RhcKolConsensusResponse, RhcBuyerQualityResponse, RhcBundleResponse, DeployerLeaderboardParams, DeployerLeaderboardResponse, RhcDeployerProfileResponse, AlphaWalletsParams, AlphaWalletsResponse, StreamToken } from "./types.js";
+import { RobinhoodChainStream } from "./stream.js";
+import type { StreamClientOptions } from "./stream.js";
+export { RobinhoodChainStream } from "./stream.js";
+export type { StreamClientOptions, StreamChannel, StreamEventName, StreamEvent, StreamLifecycleEvent, } from "./stream.js";
+export type { Chain, TradeAction, DeployerTier, Dex, RhcError, KolFeedParams, RhcKolTrade, KolFeedResponse, KolLeaderboardPeriod, KolLeaderboardParams, RhcKolLeaderboardEntry, KolLeaderboardResponse, KolHotTokensWindow, KolHotTokensParams, RhcHotToken, KolHotTokensResponse, RhcKolProfileStats, RhcKolProfileTrade, RhcKolProfileResponse, TradesParams, RhcTrade, TradesResponse, TokensSort, TokensParams, RhcTokenListItem, TokensResponse, RhcTokenDeployer, RhcTokenKolActivity, RhcTokenDetailResponse, CandlesParams, RhcCandle, CandlesResponse, RhcKolConsensus, RhcKolConsensusResponse, BuyerQualityConfidence, BuyerQualitySignal, RhcBuyerQualityBreakdown, RhcBuyerQuality, RhcBuyerQualityCoverage, RhcBuyerQualityResponse, BundleKind, RhcBundleSummary, RhcBundleWallet, RhcBundleResponse, DeployerLeaderboardSort, DeployerLeaderboardParams, RhcDeployer, DeployerLeaderboardResponse, RhcDeployerProfile, RhcDeployerRecentToken, RhcDeployerProfileResponse, AlphaClassificationFilter, AlphaIdentityFilter, AlphaSort, AlphaOrder, AlphaWalletClassification, AlphaWalletsParams, RhcAlphaWallet, AlphaWalletsResponse, StreamToken, } from "./types.js";
+export interface RobinhoodChainOptions {
+    /** MadeOnSol API key (`msk_...`) — get one free at https://madeonsol.com/pricing. */
+    apiKey: string;
+    /** API base URL (default: https://madeonsol.com). */
+    baseUrl?: string;
+}
+/** Rate-limit headers exposed alongside every successful response. */
+export interface RateLimitInfo {
+    limit: number | null;
+    remaining: number | null;
+    reset: number | null;
+    requestId: string | null;
+}
+/**
+ * Key-mode client for the Robinhood Chain (chain id 4663) API surface — live KOL
+ * trades, the DEX trade tape, token discovery/bundles/candles, deployer
+ * reputation, and smart-money wallets. Every method maps 1:1 to a
+ * GET /api/v1/rhc/… endpoint. RHC coverage is bundled into every tier.
+ */
+export declare class RobinhoodChainX402 {
+    private baseUrl;
+    private headers;
+    /** Last response's rate-limit headers (X-RateLimit-*, X-Request-Id). */
+    lastRateLimit: RateLimitInfo;
+    constructor(opts: RobinhoodChainOptions);
+    private request;
+    /**
+     * Real-time KOL trade feed on Robinhood Chain — every buy/sell from tracked
+     * Solana KOLs' verified EVM wallets, attributed via tx.from. Tier: **BASIC**.
+     * `GET /rhc/kol/feed`
+     */
+    kolFeed(params?: KolFeedParams): Promise<KolFeedResponse>;
+    /**
+     * KOL activity leaderboard — RHC KOLs ranked by trade count then net ETH flow
+     * over the window. Tier: **BASIC**. `GET /rhc/kol/leaderboard`
+     */
+    kolLeaderboard(params?: KolLeaderboardParams): Promise<KolLeaderboardResponse>;
+    /**
+     * Consensus tokens — bought by 2+ distinct tracked KOLs inside the window.
+     * Tier: **BASIC**. `GET /rhc/kol/hot-tokens`
+     */
+    kolHotTokens(params?: KolHotTokensParams): Promise<KolHotTokensResponse>;
+    /**
+     * Single KOL profile — aggregate stats over one KOL's last 200 RHC trades plus
+     * their 50 most recent trades. Tier: **BASIC**. `GET /rhc/kol/{wallet}`
+     * @param wallet KOL EVM wallet address (0x, 40 hex).
+     */
+    kol(wallet: string): Promise<RhcKolProfileResponse>;
+    /**
+     * Robinhood Chain DEX trade tape — every Uniswap v2/v3/v4 swap, each row
+     * carrying the real trader wallet (`trader_eoa`), gas/ordering for MEV
+     * analysis, and KOL/deployer flags. Cursor via `next_before`. Tier: **PRO+**.
+     * `GET /rhc/trades`
+     */
+    trades(params?: TradesParams): Promise<TradesResponse>;
+    /**
+     * Robinhood Chain token discovery — live-priced tokens with MC, liquidity,
+     * peak MC + drawdown, launchpad, and deployer tier. Tier: **PRO+**.
+     * `GET /rhc/tokens`
+     */
+    tokens(params?: TokensParams): Promise<TokensResponse>;
+    /**
+     * Full token snapshot — metadata, live price/MC/FDV, peak MC + drawdown,
+     * graduation, deployer reputation, KOL activity, and pool inventory.
+     * Tier: **BASIC**. `GET /rhc/tokens/{address}`
+     * @param address Token address (0x, 40 hex).
+     */
+    token(address: string): Promise<RhcTokenDetailResponse>;
+    /**
+     * 1-minute OHLC candles — price + market-cap OHLC, close liquidity, volume
+     * with buy/sell split, and trade/buy/sell counts. Tier: **PRO+**.
+     * `GET /rhc/tokens/{address}/candles`
+     */
+    tokenCandles(address: string, params?: CandlesParams): Promise<CandlesResponse>;
+    /**
+     * KOL consensus on a token — distinct KOL buyers vs sellers, exit rate, net
+     * ETH flow (`net_flow_eth`), median entry MC, and first-touch. ULTRA adds the
+     * `buyers`/`exited` wallet lists. Tier: **PRO+**.
+     * `GET /rhc/tokens/{address}/kol-consensus`
+     */
+    tokenKolConsensus(address: string): Promise<RhcKolConsensusResponse>;
+    /**
+     * Early-buyer quality — a 0–100 read on a token's first-20 buyer cohort:
+     * win-rate, KOL-presence, bot-domination, bundle-buyer, and the informational
+     * dump-cluster ensemble. Tier: **BASIC**.
+     * `GET /rhc/tokens/{address}/buyer-quality`
+     */
+    tokenBuyerQuality(address: string): Promise<RhcBuyerQualityResponse>;
+    /**
+     * Launch-bundle detection — flags a `same_block` bundle in the earliest-buyer
+     * cohort and reports how much of what it bought it still holds. Field-gated by
+     * tier: BASIC scalar `bundle`; PRO top-10 wallets; ULTRA full cohort with
+     * identity. Tier: **BASIC**. `GET /rhc/tokens/{address}/bundle`
+     */
+    tokenBundle(address: string): Promise<RhcBundleResponse>;
+    /**
+     * Deployer reputation leaderboard — RHC deployers ranked by reputation over
+     * every indexed launchpad token (40k+ deployers). `graduation_rate` = share at
+     * $40K+ peak MC; `runner_rate` = share at $100K+. Tier: **BASIC**.
+     * `GET /rhc/deployer-hunter/leaderboard`
+     */
+    deployerLeaderboard(params?: DeployerLeaderboardParams): Promise<DeployerLeaderboardResponse>;
+    /**
+     * Single deployer profile — full reputation row plus the 50 most recent tokens
+     * enriched with live MC and peak MC. Unknown wallets return 200 with
+     * `is_deployer: false`. Tier: **BASIC**. `GET /rhc/deployer-hunter/{address}`
+     * @param address Deployer EVM wallet address (0x, 40 hex).
+     */
+    deployer(address: string): Promise<RhcDeployerProfileResponse>;
+    /**
+     * Smart-money wallet ranking — RHC trader wallets ranked by realized on-chain
+     * performance (`net_eth`, `win_rate`, `memecoin_share`, `likely_bot`). Tier:
+     * **PRO+**. `GET /rhc/alpha-wallets`
+     */
+    alphaWallets(params?: AlphaWalletsParams): Promise<AlphaWalletsResponse>;
+    /** Generate a 24h WebSocket streaming token (PRO/ULTRA). */
+    getStreamToken(): Promise<StreamToken>;
+    /**
+     * Open a managed real-time Robinhood Chain WebSocket stream. Handles token
+     * fetch + refresh, auto-reconnect with backoff, heartbeat liveness, and typed
+     * events for you. Channels: `rhc:kol_trades`, `rhc:trades`.
+     *
+     * @example
+     * const stream = client.stream();
+     * stream.on("rhc:kol_trade", (t) => console.log(t));
+     * stream.subscribe(["rhc:kol_trades"]);
+     */
+    stream(opts?: Omit<StreamClientOptions, "getToken">): RobinhoodChainStream;
+}
+/**
+ * Create a Robinhood Chain client with API-key auth.
+ * @param apiKey Your `msk_` API key — get one free at https://madeonsol.com/pricing.
+ * @param baseUrl Optional API base URL override.
+ */
+export declare function createClient(apiKey: string, baseUrl?: string): RobinhoodChainX402;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,212 @@
+import { RobinhoodChainStream } from "./stream.js";
+import { VERSION } from "./version.js";
+export { RobinhoodChainStream } from "./stream.js";
+const DEFAULT_BASE_URL = "https://madeonsol.com";
+/**
+ * Key-mode client for the Robinhood Chain (chain id 4663) API surface — live KOL
+ * trades, the DEX trade tape, token discovery/bundles/candles, deployer
+ * reputation, and smart-money wallets. Every method maps 1:1 to a
+ * GET /api/v1/rhc/… endpoint. RHC coverage is bundled into every tier.
+ */
+export class RobinhoodChainX402 {
+    baseUrl;
+    headers;
+    /** Last response's rate-limit headers (X-RateLimit-*, X-Request-Id). */
+    lastRateLimit = { limit: null, remaining: null, reset: null, requestId: null };
+    constructor(opts) {
+        this.baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+        if (!opts.apiKey) {
+            console.error("\n[robinhood-chain-x402] Missing apiKey.\n" +
+                "  → Get a free API key (200 req/day, no card) at https://madeonsol.com/pricing\n" +
+                "  → RHC coverage is bundled into every tier at no extra cost.\n");
+            throw new Error("Provide apiKey. Get a free API key at https://madeonsol.com/pricing");
+        }
+        this.headers = {
+            "User-Agent": `robinhood-chain-x402/${VERSION}`,
+            Authorization: `Bearer ${opts.apiKey}`,
+        };
+    }
+    async request(path, params) {
+        const url = new URL(`/api/v1${path}`, this.baseUrl);
+        if (params) {
+            for (const [k, v] of Object.entries(params)) {
+                if (v !== undefined)
+                    url.searchParams.set(k, String(v));
+            }
+        }
+        const res = await fetch(url.toString(), { headers: this.headers });
+        this.lastRateLimit = {
+            limit: numHeader(res, "x-ratelimit-limit"),
+            remaining: numHeader(res, "x-ratelimit-remaining"),
+            reset: numHeader(res, "x-ratelimit-reset"),
+            requestId: res.headers.get("x-request-id"),
+        };
+        if (!res.ok) {
+            const body = await res.text().catch(() => "");
+            throw new Error(`Robinhood Chain API error ${res.status}: ${body}`);
+        }
+        return res.json();
+    }
+    /* ── KOL intelligence ── */
+    /**
+     * Real-time KOL trade feed on Robinhood Chain — every buy/sell from tracked
+     * Solana KOLs' verified EVM wallets, attributed via tx.from. Tier: **BASIC**.
+     * `GET /rhc/kol/feed`
+     */
+    async kolFeed(params) {
+        return this.request("/rhc/kol/feed", params);
+    }
+    /**
+     * KOL activity leaderboard — RHC KOLs ranked by trade count then net ETH flow
+     * over the window. Tier: **BASIC**. `GET /rhc/kol/leaderboard`
+     */
+    async kolLeaderboard(params) {
+        return this.request("/rhc/kol/leaderboard", params);
+    }
+    /**
+     * Consensus tokens — bought by 2+ distinct tracked KOLs inside the window.
+     * Tier: **BASIC**. `GET /rhc/kol/hot-tokens`
+     */
+    async kolHotTokens(params) {
+        return this.request("/rhc/kol/hot-tokens", params);
+    }
+    /**
+     * Single KOL profile — aggregate stats over one KOL's last 200 RHC trades plus
+     * their 50 most recent trades. Tier: **BASIC**. `GET /rhc/kol/{wallet}`
+     * @param wallet KOL EVM wallet address (0x, 40 hex).
+     */
+    async kol(wallet) {
+        return this.request(`/rhc/kol/${encodeURIComponent(wallet)}`);
+    }
+    /* ── DEX trade tape ── */
+    /**
+     * Robinhood Chain DEX trade tape — every Uniswap v2/v3/v4 swap, each row
+     * carrying the real trader wallet (`trader_eoa`), gas/ordering for MEV
+     * analysis, and KOL/deployer flags. Cursor via `next_before`. Tier: **PRO+**.
+     * `GET /rhc/trades`
+     */
+    async trades(params) {
+        return this.request("/rhc/trades", params);
+    }
+    /* ── Token discovery + intelligence ── */
+    /**
+     * Robinhood Chain token discovery — live-priced tokens with MC, liquidity,
+     * peak MC + drawdown, launchpad, and deployer tier. Tier: **PRO+**.
+     * `GET /rhc/tokens`
+     */
+    async tokens(params) {
+        return this.request("/rhc/tokens", params);
+    }
+    /**
+     * Full token snapshot — metadata, live price/MC/FDV, peak MC + drawdown,
+     * graduation, deployer reputation, KOL activity, and pool inventory.
+     * Tier: **BASIC**. `GET /rhc/tokens/{address}`
+     * @param address Token address (0x, 40 hex).
+     */
+    async token(address) {
+        return this.request(`/rhc/tokens/${encodeURIComponent(address)}`);
+    }
+    /**
+     * 1-minute OHLC candles — price + market-cap OHLC, close liquidity, volume
+     * with buy/sell split, and trade/buy/sell counts. Tier: **PRO+**.
+     * `GET /rhc/tokens/{address}/candles`
+     */
+    async tokenCandles(address, params) {
+        return this.request(`/rhc/tokens/${encodeURIComponent(address)}/candles`, params);
+    }
+    /**
+     * KOL consensus on a token — distinct KOL buyers vs sellers, exit rate, net
+     * ETH flow (`net_flow_eth`), median entry MC, and first-touch. ULTRA adds the
+     * `buyers`/`exited` wallet lists. Tier: **PRO+**.
+     * `GET /rhc/tokens/{address}/kol-consensus`
+     */
+    async tokenKolConsensus(address) {
+        return this.request(`/rhc/tokens/${encodeURIComponent(address)}/kol-consensus`);
+    }
+    /**
+     * Early-buyer quality — a 0–100 read on a token's first-20 buyer cohort:
+     * win-rate, KOL-presence, bot-domination, bundle-buyer, and the informational
+     * dump-cluster ensemble. Tier: **BASIC**.
+     * `GET /rhc/tokens/{address}/buyer-quality`
+     */
+    async tokenBuyerQuality(address) {
+        return this.request(`/rhc/tokens/${encodeURIComponent(address)}/buyer-quality`);
+    }
+    /**
+     * Launch-bundle detection — flags a `same_block` bundle in the earliest-buyer
+     * cohort and reports how much of what it bought it still holds. Field-gated by
+     * tier: BASIC scalar `bundle`; PRO top-10 wallets; ULTRA full cohort with
+     * identity. Tier: **BASIC**. `GET /rhc/tokens/{address}/bundle`
+     */
+    async tokenBundle(address) {
+        return this.request(`/rhc/tokens/${encodeURIComponent(address)}/bundle`);
+    }
+    /* ── Deployer hunter ── */
+    /**
+     * Deployer reputation leaderboard — RHC deployers ranked by reputation over
+     * every indexed launchpad token (40k+ deployers). `graduation_rate` = share at
+     * $40K+ peak MC; `runner_rate` = share at $100K+. Tier: **BASIC**.
+     * `GET /rhc/deployer-hunter/leaderboard`
+     */
+    async deployerLeaderboard(params) {
+        return this.request("/rhc/deployer-hunter/leaderboard", params);
+    }
+    /**
+     * Single deployer profile — full reputation row plus the 50 most recent tokens
+     * enriched with live MC and peak MC. Unknown wallets return 200 with
+     * `is_deployer: false`. Tier: **BASIC**. `GET /rhc/deployer-hunter/{address}`
+     * @param address Deployer EVM wallet address (0x, 40 hex).
+     */
+    async deployer(address) {
+        return this.request(`/rhc/deployer-hunter/${encodeURIComponent(address)}`);
+    }
+    /* ── Smart money ── */
+    /**
+     * Smart-money wallet ranking — RHC trader wallets ranked by realized on-chain
+     * performance (`net_eth`, `win_rate`, `memecoin_share`, `likely_bot`). Tier:
+     * **PRO+**. `GET /rhc/alpha-wallets`
+     */
+    async alphaWallets(params) {
+        return this.request("/rhc/alpha-wallets", params);
+    }
+    /* ── Streaming ── */
+    /** Generate a 24h WebSocket streaming token (PRO/ULTRA). */
+    async getStreamToken() {
+        const url = new URL("/api/v1/stream/token", this.baseUrl);
+        const res = await fetch(url.toString(), { method: "POST", headers: this.headers });
+        if (!res.ok) {
+            const body = await res.text().catch(() => "");
+            throw new Error(`Robinhood Chain API error ${res.status}: ${body}`);
+        }
+        return res.json();
+    }
+    /**
+     * Open a managed real-time Robinhood Chain WebSocket stream. Handles token
+     * fetch + refresh, auto-reconnect with backoff, heartbeat liveness, and typed
+     * events for you. Channels: `rhc:kol_trades`, `rhc:trades`.
+     *
+     * @example
+     * const stream = client.stream();
+     * stream.on("rhc:kol_trade", (t) => console.log(t));
+     * stream.subscribe(["rhc:kol_trades"]);
+     */
+    stream(opts) {
+        return new RobinhoodChainStream({ ...opts, getToken: () => this.getStreamToken() });
+    }
+}
+function numHeader(res, name) {
+    const v = res.headers.get(name);
+    if (v == null)
+        return null;
+    const n = Number(v);
+    return Number.isFinite(n) ? n : null;
+}
+/**
+ * Create a Robinhood Chain client with API-key auth.
+ * @param apiKey Your `msk_` API key — get one free at https://madeonsol.com/pricing.
+ * @param baseUrl Optional API base URL override.
+ */
+export function createClient(apiKey, baseUrl) {
+    return new RobinhoodChainX402({ apiKey, baseUrl });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/stream.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Real-time Robinhood Chain WebSocket streaming client.
+ *
+ * Wraps the connect → token → subscribe → event loop with auto-reconnect,
+ * 24h-token auto-refresh, heartbeat liveness, and typed events, so consumers
+ * never hand-roll connection management. Obtain one via `client.stream()`.
+ *
+ * Channels are RHC-scoped: `rhc:kol_trades` (the KOL tape) and `rhc:trades`
+ * (the full DEX firehose). Same wire protocol as the Solana stream client.
+ *
+ * Works in Node (uses the global `WebSocket` on Node 22+, else lazily imports
+ * the optional `ws` package) and the browser (native WebSocket). Zero required
+ * dependencies.
+ */
+import type { StreamToken } from "./types";
+/** Robinhood Chain channels you can subscribe to. */
+export type StreamChannel = "rhc:kol_trades" | "rhc:trades";
+/** Event names delivered on those channels. */
+export type StreamEventName = "rhc:kol_trade" | "rhc:trade";
+/** Lifecycle events you can also listen for. */
+export type StreamLifecycleEvent = "open" | "close" | "reconnect" | "subscribed" | "heartbeat" | "error";
+export interface StreamEvent<T = unknown> {
+    channel: StreamChannel;
+    event: StreamEventName;
+    data: T;
+    ts: number;
+}
+export interface StreamClientOptions {
+    /** Returns a fresh 24h stream token (the SDK wires this to getStreamToken()). */
+    getToken: () => Promise<StreamToken>;
+    /** Reconnect automatically on drop (default: true). */
+    autoReconnect?: boolean;
+    /** Max reconnect backoff in ms (default: 30000). */
+    maxBackoffMs?: number;
+    /** Reconnect if no server heartbeat arrives within this window (default: 90000). */
+    heartbeatTimeoutMs?: number;
+    /** Override the WebSocket implementation (e.g. inject `ws` explicitly). */
+    WebSocketImpl?: unknown;
+}
+type Listener = (data: unknown, evt?: StreamEvent) => void;
+export declare class RobinhoodChainStream {
+    private opts;
+    private ws;
+    private listeners;
+    private desired;
+    private closedByUser;
+    private attempt;
+    private hbTimer;
+    private reconnectTimer;
+    private connecting;
+    constructor(opts: StreamClientOptions);
+    /** Register a handler. Use an event name, `"*"` for every event, or a lifecycle event. */
+    on(event: StreamEventName | StreamLifecycleEvent | "*", fn: Listener): this;
+    /** Remove a handler (or all handlers for an event when `fn` is omitted). */
+    off(event: string, fn?: Listener): this;
+    private emit;
+    /** Subscribe to one or more channels (connects on first call). Optional server-side filters. */
+    subscribe(channels: StreamChannel[], filters?: Record<string, unknown>): this;
+    /** Stop receiving the given channels. */
+    unsubscribe(channels: StreamChannel[]): this;
+    /** Open the connection (also called implicitly by subscribe). */
+    connect(): Promise<void>;
+    /** Close the connection and stop reconnecting. */
+    close(): void;
+    private sendSubscribe;
+    private handleMessage;
+    private scheduleReconnect;
+    private resetHeartbeat;
+    private clearHeartbeat;
+}
+export {};
+//# sourceMappingURL=stream.d.ts.map

package/dist/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,qDAAqD;AACrD,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,YAAY,CAAC;AAE5D,+CAA+C;AAC/C,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,WAAW,CAAC;AAE5D,gDAAgD;AAChD,MAAM,MAAM,oBAAoB,GAC5B,MAAM,GACN,OAAO,GACP,WAAW,GACX,YAAY,GACZ,WAAW,GACX,OAAO,CAAC;AAEZ,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,eAAe,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC;IACR,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,mBAAmB;IAClC,iFAAiF;IACjF,QAAQ,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;IACrC,uDAAuD;IACvD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,2EAA2E;IAC3E,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,KAAK,QAAQ,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,WAAW,KAAK,IAAI,CAAC;AAqC3D,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,IAAI,CAAoG;IAChH,OAAO,CAAC,EAAE,CAA8B;IACxC,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,OAAO,CAAkF;IACjG,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,OAAO,CAA8C;IAC7D,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,UAAU,CAAS;gBAEf,IAAI,EAAE,mBAAmB;IAUrC,0FAA0F;IAC1F,EAAE,CAAC,KAAK,EAAE,eAAe,GAAG,oBAAoB,GAAG,GAAG,EAAE,EAAE,EAAE,QAAQ,GAAG,IAAI;IAM3E,4EAA4E;IAC5E,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI;IAMvC,OAAO,CAAC,IAAI;IAKZ,gGAAgG;IAChG,SAAS,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAQ7E,yCAAyC;IACzC,WAAW,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,IAAI;IAQ5C,iEAAiE;IAC3D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC9B,kDAAkD;IAClD,KAAK,IAAI,IAAI;IAeb,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,cAAc;CAGvB"}