@stockkit/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 StockKit Labs
+
+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,86 @@
+# @stockkit/sdk
+
+TypeScript client for the [StockKit API](https://api.stockkit.dev): tokenized stocks on [Robinhood Chain](https://robinhoodchain.blockscout.com).
+
+StockKit gives developers one layer for discovering tokenized assets, reading live prices, valuing portfolios, getting executable DEX quotes, and building trades. It is non-custodial: the API returns unsigned transactions, and you sign with your own wallet. StockKit never holds keys and never executes trades.
+
+Docs: https://docs.stockkit.dev
+
+## Install
+
+```bash
+npm install @stockkit/sdk
+```
+
+## Usage
+
+```ts
+import { StockKit } from "@stockkit/sdk"
+
+const stockkit = new StockKit()
+
+// All tokenized assets on Robinhood Chain, with onchain addresses
+const { assets } = await stockkit.assets.list()
+
+// Live price (raw underlying and multiplier-adjusted per-token values)
+const price = await stockkit.prices.get("NVDA")
+
+// Any wallet's tokenized-stock positions, valued in USD
+const portfolio = await stockkit.portfolio.get("0xYourWalletAddress")
+
+// Executable quote from Uniswap v3 pools on Robinhood Chain
+const quote = await stockkit.trade.quote({ ticker: "NVDA", amount: 100 })
+
+// Unsigned approve + swap transactions; sign with your own wallet
+const tx = await stockkit.trade.build({
+  ticker: "NVDA",
+  amount: 100,
+  recipient: "0xYourWalletAddress",
+  slippageBps: 50,
+})
+```
+
+Signing and submitting the built steps is up to you, for example with viem:
+
+```ts
+for (const step of tx.steps) {
+  await walletClient.sendTransaction({
+    to: step.to as `0x${string}`,
+    data: step.data as `0x${string}`,
+    value: BigInt(step.value),
+  })
+}
+```
+
+## API surface
+
+| Method | Endpoint |
+| --- | --- |
+| `assets.list()` | `GET /v1/assets` |
+| `assets.get(symbol)` | `GET /v1/assets/:symbol` |
+| `prices.get(symbol)` | `GET /v1/prices/:symbol` |
+| `portfolio.get(address)` | `GET /v1/portfolio/:address` |
+| `corporateActions.list()` | `GET /v1/corporate-actions` |
+| `trade.quote(params)` | `GET /v1/quote` |
+| `trade.build(params)` | `POST /v1/trade/build` |
+
+All responses are fully typed. Errors throw `StockKitError` with `status` and `code`.
+
+## Options
+
+```ts
+new StockKit({
+  baseUrl: "https://api.stockkit.dev", // default
+  fetch: customFetch,                  // optional fetch implementation
+})
+```
+
+The API is open during the beta; no API key is required.
+
+## Disclaimer
+
+StockKit provides software infrastructure only. Nothing in this package is investment advice, and tokenized assets carry risk. Review every transaction before signing.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,134 @@
+export type Asset = {
+    symbol: string;
+    name: string;
+    address: string;
+    chainId: number;
+    decimals: number;
+    multiplier: string;
+    pendingMultiplier: string | null;
+    status: string;
+    logoUrl: string;
+    tradingCapabilities: unknown;
+    isin: string;
+};
+export type Price = {
+    symbol: string;
+    currency: string;
+    underlying: {
+        bid: string;
+        ask: string;
+        mid: string;
+    };
+    token: {
+        bid: string;
+        ask: string;
+        mid: string;
+        multiplier: string;
+    };
+    dailyHigh: string;
+    dailyLow: string;
+    dailyTradingVolume: string;
+    halted: boolean;
+    asOf: string;
+};
+export type Position = {
+    symbol: string;
+    name: string;
+    address: string;
+    balance: string;
+    decimals: number;
+    usdPrice: string | null;
+    usdValue: string | null;
+};
+export type Portfolio = {
+    address: string;
+    chainId: number;
+    positions: Position[];
+    totalUsdValue: string;
+    asOf: string;
+};
+export type Quote = {
+    symbol: string;
+    tokenAddress: string;
+    side: "buy" | "sell";
+    mode: "exactIn" | "exactOut";
+    feeTier: number;
+    usdAmount: string;
+    tokenAmount: string;
+    effectivePricePerToken: string | null;
+    gasEstimate: string;
+    venue: string;
+    pair: string;
+    asOf: string;
+};
+export type TransactionStep = {
+    description: string;
+    to: string;
+    data: string;
+    value: string;
+};
+export type BuiltTrade = {
+    symbol: string;
+    tokenAddress: string;
+    chainId: number;
+    quote: Omit<Quote, "symbol" | "tokenAddress" | "asOf">;
+    slippageBps: number;
+    deadline: number;
+    steps: TransactionStep[];
+    note: string;
+};
+export type QuoteParams = {
+    ticker: string;
+    side?: "buy" | "sell";
+    amount: number | string;
+    denom?: "usd" | "token";
+};
+export type BuildParams = QuoteParams & {
+    recipient: string;
+    slippageBps?: number;
+};
+export declare class StockKitError extends Error {
+    status: number;
+    code: string;
+    constructor(message: string, status: number, code: string);
+}
+export type StockKitOptions = {
+    baseUrl?: string;
+    /** Reserved for future authenticated endpoints. */
+    apiKey?: string;
+    fetch?: typeof fetch;
+};
+export declare class StockKit {
+    private baseUrl;
+    private fetchFn;
+    private apiKey?;
+    constructor(options?: StockKitOptions);
+    private request;
+    assets: {
+        list: () => Promise<{
+            assets: Asset[];
+            count: number;
+        }>;
+        get: (symbol: string) => Promise<Asset>;
+    };
+    prices: {
+        get: (symbol: string) => Promise<Price>;
+    };
+    portfolio: {
+        get: (address: string) => Promise<Portfolio>;
+    };
+    corporateActions: {
+        list: () => Promise<{
+            corpActions: unknown[];
+        }>;
+    };
+    trade: {
+        quote: (params: QuoteParams) => Promise<Quote>;
+        /**
+         * Builds unsigned transactions for the swap. Sign and submit them with
+         * your own wallet (viem, ethers, etc.); StockKit never touches keys.
+         */
+        build: (params: BuildParams) => Promise<BuiltTrade>;
+    };
+}
+export default StockKit;

package/dist/index.js

@@ -0,0 +1,76 @@
+// StockKit SDK: thin typed client for api.stockkit.dev.
+// Read data, get DEX quotes, and build unsigned transactions for tokenized
+// stocks on Robinhood Chain. StockKit never holds keys or executes trades.
+export class StockKitError extends Error {
+    status;
+    code;
+    constructor(message, status, code) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = "StockKitError";
+    }
+}
+export class StockKit {
+    baseUrl;
+    fetchFn;
+    apiKey;
+    constructor(options = {}) {
+        this.baseUrl = (options.baseUrl ?? "https://api.stockkit.dev").replace(/\/$/, "");
+        this.fetchFn = options.fetch ?? fetch;
+        this.apiKey = options.apiKey;
+    }
+    async request(path, init) {
+        const headers = { accept: "application/json" };
+        if (init?.body)
+            headers["content-type"] = "application/json";
+        if (this.apiKey)
+            headers.authorization = `Bearer ${this.apiKey}`;
+        const res = await this.fetchFn(`${this.baseUrl}${path}`, { ...init, headers });
+        const body = (await res.json());
+        if (!res.ok) {
+            throw new StockKitError(body?.error?.message ?? `Request failed with ${res.status}`, res.status, body?.error?.code ?? "unknown");
+        }
+        return body;
+    }
+    assets = {
+        list: () => this.request("/v1/assets"),
+        get: (symbol) => this.request(`/v1/assets/${encodeURIComponent(symbol)}`),
+    };
+    prices = {
+        get: (symbol) => this.request(`/v1/prices/${encodeURIComponent(symbol)}`),
+    };
+    portfolio = {
+        get: (address) => this.request(`/v1/portfolio/${encodeURIComponent(address)}`),
+    };
+    corporateActions = {
+        list: () => this.request("/v1/corporate-actions"),
+    };
+    trade = {
+        quote: (params) => {
+            const search = new URLSearchParams({
+                symbol: params.ticker,
+                side: params.side ?? "buy",
+                amount: String(params.amount),
+                denom: params.denom ?? "usd",
+            });
+            return this.request(`/v1/quote?${search}`);
+        },
+        /**
+         * Builds unsigned transactions for the swap. Sign and submit them with
+         * your own wallet (viem, ethers, etc.); StockKit never touches keys.
+         */
+        build: (params) => this.request("/v1/trade/build", {
+            method: "POST",
+            body: JSON.stringify({
+                symbol: params.ticker,
+                side: params.side ?? "buy",
+                amount: String(params.amount),
+                denom: params.denom ?? "usd",
+                recipient: params.recipient,
+                slippageBps: params.slippageBps,
+            }),
+        }),
+    };
+}
+export default StockKit;

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@stockkit/sdk",
+  "version": "0.1.0",
+  "description": "TypeScript client for the StockKit API: tokenized stocks on Robinhood Chain.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "sideEffects": false,
+  "license": "MIT",
+  "author": "StockKit Labs",
+  "homepage": "https://stockkit.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stockkit-labs/sdk.git"
+  },
+  "bugs": "https://github.com/stockkit-labs/sdk/issues",
+  "keywords": [
+    "stockkit",
+    "robinhood-chain",
+    "tokenized-stocks",
+    "rwa",
+    "defi",
+    "trading",
+    "typescript"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "check": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  }
+}