@surf-ai/sdk 0.1.0 → 0.1.4

package/dist/server/index.js

@@ -459,19 +459,19 @@ var fund = {
 // src/data/categories/kalshi.ts
 var kalshi = {
   /** Get Kalshi events with nested markets, optionally filtered by `event_ticker`. Each event includes market count and a list of markets. Data refresh: ~30 minutes */
-  events: (params) => get("kalshi/events", params),
+  events: (params) => get("prediction-market/kalshi/events", params),
   /** Get Kalshi markets, optionally filtered by `market_ticker`. Each market includes price, volume, and status. Data refresh: ~30 minutes */
-  markets: (params) => get("kalshi/markets", params),
+  markets: (params) => get("prediction-market/kalshi/markets", params),
   /** Get daily open interest history for a Kalshi market filtered by `time_range`. Data refresh: ~30 minutes */
-  open_interest: (params) => get("kalshi/open-interest", params),
+  open_interest: (params) => get("prediction-market/kalshi/open-interest", params),
   /** Get price history for a Kalshi market. Use `interval=1d` for daily OHLC from market reports (~30 min delay), or `interval=latest` for real-time price from trades. Data refresh: ~30 minutes (daily), real-time (latest) */
-  prices: (params) => get("kalshi/prices", params),
+  prices: (params) => get("prediction-market/kalshi/prices", params),
   /** Get top-ranked Kalshi markets by last day's `notional_volume_usd` or `open_interest`. Filter by `status`. Data refresh: ~30 minutes */
-  ranking: (params) => get("kalshi/ranking", params),
+  ranking: (params) => get("prediction-market/kalshi/ranking", params),
   /** Get individual trade records for a Kalshi market. Filter by `taker_side`, `min_contracts`, and date range. Sort by `timestamp` or `num_contracts`. Data refresh: real-time */
-  trades: (params) => get("kalshi/trades", params),
+  trades: (params) => get("prediction-market/kalshi/trades", params),
   /** Get daily trading volume history for a Kalshi market filtered by `time_range`. Data refresh: ~30 minutes */
-  volumes: (params) => get("kalshi/volumes", params)
+  volumes: (params) => get("prediction-market/kalshi/volumes", params)
 };
 
 // src/data/categories/market.ts
@@ -483,11 +483,11 @@ var market = {
   /** Get futures market data across all tracked tokens — open interest, funding rate, long/short ratio, and 24h volume. Sort by `sort_by` (default: volume_24h). */
   futures: (params) => get("market/futures", params),
   /** Get OHLC-style aggregated liquidation data for a token on a specific exchange. Filter by `symbol`, `exchange`, and `interval`. Useful for charting liquidation volume over time. */
-  liquidation_chart: (params) => get("market/liquidation-chart", params),
+  liquidation_chart: (params) => get("market/liquidation/chart", params),
   /** Get liquidation breakdown by exchange — total, long, and short volumes in USD. Filter by `symbol` and `time_range` (`1h`, `4h`, `12h`, `24h`). */
-  liquidation_exchange_list: (params) => get("market/liquidation-exchange-list", params),
+  liquidation_exchange_list: (params) => get("market/liquidation/exchange-list", params),
   /** Get individual large liquidation orders above a USD threshold (`min_amount`, default 10000). Filter by `exchange` and `symbol`. For aggregate totals and long/short breakdown by exchange, use `/market/liquidation/exchange-list`. For historical liquidation charts, use `/market/liquidation/chart`. */
-  liquidation_order: (params) => get("market/liquidation-order", params),
+  liquidation_order: (params) => get("market/liquidation/order", params),
   /** Get on-chain indicator time-series for BTC or ETH. Metrics: `nupl`, `sopr`, `mvrv`, `puell-multiple`, `nvm`, `nvt`, `nvt-golden-cross`, `exchange-flows` (inflow/outflow/netflow/reserve). */
   onchain_indicator: (params) => get("market/onchain-indicator", params),
   /** Get options market data — open interest, volume, put/call ratio, and max pain price for a `symbol`. */
@@ -511,41 +511,41 @@ var news = {
 // src/data/categories/onchain.ts
 var onchain = {
   /** List bridge protocols ranked by total USD volume over a time range. */
-  bridge_ranking: (params) => get("onchain/bridge-ranking", params),
+  bridge_ranking: (params) => get("onchain/bridge/ranking", params),
   /** Get the current gas price for an EVM chain via `eth_gasPrice` JSON-RPC. Returns gas price in both wei (raw) and Gwei (human-readable). **Supported chains:** `ethereum`, `polygon`, `bsc`, `arbitrum`, `optimism`, `base`, `avalanche`, `fantom`, `linea`, `cyber`. */
   gas_price: (params) => get("onchain/gas-price", params),
-  /** Execute a structured JSON query on blockchain data. No raw SQL needed — specify source, fields, filters, sort, and pagination. All tables live in the **agent** database. Use `GET /v1/onchain/schema` to discover available tables and their columns. - Source format: `agent.<table_name>` like `agent.ethereum_transactions` or `agent.ethereum_dex_trades` - Max 10,000 rows (default 20), 30s timeout. - **Always filter on block_date** — it is the partition key. Without it, queries scan billions of rows and will timeout. - **Data refresh:** ~24 hours. */
-  structured_query: (body) => post("onchain/structured-query", body),
+  /** Execute a structured JSON query on blockchain data. No raw SQL needed — specify source, fields, filters, sort, and pagination. All tables live in the **agent** database. Use `GET /v1/onchain/schema` to discover available tables and their columns. - Source format: `agent.<table_name>` like `agent.ethereum_transactions` or `agent.ethereum_dex_trades` - Max 10,000 rows (default 20), 30s timeout. - **Always filter on block_date** — it is the partition key. Without it, queries scan billions of rows and will timeout. - **Data refresh:** ~24 hours. ## Example ```json { "source": "agent.ethereum_dex_trades", "fields": ["block_time", "project", "token_pair", "amount_usd", "taker"], "filters": [ {"field": "block_date", "op": "gte", "value": "2025-03-01"}, {"field": "project", "op": "eq", "value": "uniswap"}, {"field": "amount_usd", "op": "gte", "value": 100000} ], "sort": [{"field": "amount_usd", "order": "desc"}], "limit": 20 } ``` */
+  structured_query: (body) => post("onchain/query", body),
   /** Get table metadata — database, table, column names, types, and comments for all available on-chain databases. */
   schema: () => get("onchain/schema"),
-  /** Execute a raw SQL SELECT query against blockchain data. All tables live in the **agent** database. Use `GET /v1/onchain/schema` to discover available tables and their columns before writing queries. */
+  /** Execute a raw SQL SELECT query against blockchain data. All tables live in the **agent** database. Use `GET /v1/onchain/schema` to discover available tables and their columns before writing queries. ## Rules - Only SELECT/WITH statements allowed (read-only). - All table references must be database-qualified: `agent.<table_name>`. - Max 10,000 rows (default 1,000), 30s timeout. - **Always filter on block_date or block_number** — partition key, without it queries will timeout. - Avoid `SELECT *` on large tables. Specify only the columns you need. - **Data refresh:** ~24 hours. ## Example ```sql SELECT block_time, token_pair, amount_usd, taker, tx_hash FROM agent.ethereum_dex_trades WHERE block_date >= today() - 7 AND project = 'uniswap' AND amount_usd > 100000 ORDER BY amount_usd DESC LIMIT 20 ``` */
   sql: (body) => post("onchain/sql", body),
   /** Get transaction details by hash. All numeric fields are hex-encoded — use parseInt(hex, 16) to convert. **Supported chains:** `ethereum`, `polygon`, `bsc`, `arbitrum`, `optimism`, `base`, `avalanche`, `fantom`, `linea`, `cyber`. Returns 404 if the transaction is not found. */
   tx: (params) => get("onchain/tx", params),
   /** List DeFi yield pools ranked by APY or TVL. Returns the latest snapshot. Filter by protocol. */
-  yield_ranking: (params) => get("onchain/yield-ranking", params)
+  yield_ranking: (params) => get("onchain/yield/ranking", params)
 };
 
 // src/data/categories/polymarket.ts
 var polymarket = {
   /** Get trade and redemption activity for a Polymarket wallet. Data refresh: ~30 minutes */
-  activity: (params) => get("polymarket/activity", params),
+  activity: (params) => get("prediction-market/polymarket/activity", params),
   /** Get Polymarket events with nested markets, optionally filtered by `event_slug`. Each event includes aggregated status, volume, and a list of markets with `side_a`/`side_b` outcomes. Data refresh: ~30 minutes */
-  events: (params) => get("polymarket/events", params),
+  events: (params) => get("prediction-market/polymarket/events", params),
   /** Get Polymarket markets, optionally filtered by `market_slug`. Each market includes `side_a` and `side_b` outcomes. Current prices are available via `/polymarket/prices` using the `condition_id`. Data refresh: ~30 minutes */
-  markets: (params) => get("polymarket/markets", params),
+  markets: (params) => get("prediction-market/polymarket/markets", params),
   /** Get daily open interest history for a Polymarket market. Data refresh: ~30 minutes */
-  open_interest: (params) => get("polymarket/open-interest", params),
+  open_interest: (params) => get("prediction-market/polymarket/open-interest", params),
   /** Get wallet positions on Polymarket markets. Data refresh: ~30 minutes */
-  positions: (params) => get("polymarket/positions", params),
+  positions: (params) => get("prediction-market/polymarket/positions", params),
   /** Get aggregated price history for a Polymarket market. Use `interval=latest` for the most recent price snapshot. Data refresh: ~30 minutes */
-  prices: (params) => get("polymarket/prices", params),
+  prices: (params) => get("prediction-market/polymarket/prices", params),
   /** Get top-ranked Polymarket markets by `volume_24h`, `volume_7d`, `open_interest`, or `trade_count`. Filter by `status` and `end_before`. Data refresh: ~30 minutes */
-  ranking: (params) => get("polymarket/ranking", params),
+  ranking: (params) => get("prediction-market/polymarket/ranking", params),
   /** Get paginated trade records for a Polymarket market or wallet. Filter by `condition_id` (market) or `address` (wallet), plus `outcome_label`, `min_amount`, and date range. At least one of `condition_id` or `address` is required. Sort by `newest`, `oldest`, or `largest`. Data refresh: ~30 minutes */
-  trades: (params) => get("polymarket/trades", params),
+  trades: (params) => get("prediction-market/polymarket/trades", params),
   /** Get trading volume and trade count history for a Polymarket market. Data refresh: ~30 minutes */
-  volumes: (params) => get("polymarket/volumes", params)
+  volumes: (params) => get("prediction-market/polymarket/volumes", params)
 };
 
 // src/data/categories/prediction_market.ts
@@ -557,9 +557,9 @@ var prediction_market = {
 // src/data/categories/project.ts
 var project = {
   /** Get time-series DeFi metrics for a project. Available metrics: `volume`, `fee`, `fees`, `revenue`, `tvl`, `users`. Lookup by UUID (`id`) or name (`q`). Filter by `chain` and date range (`from`/`to`). Returns 404 if the project is not found. **Note:** this endpoint only returns data for DeFi protocol projects (e.g. `aave`, `uniswap`, `lido`, `makerdao`). Use `q` with a DeFi protocol name. */
-  defi_metrics: (params) => get("project/defi-metrics", params),
+  defi_metrics: (params) => get("project/defi/metrics", params),
   /** Get top DeFi projects ranked by a protocol metric. Available metrics: `tvl`, `revenue`, `fees`, `volume`, `users`. */
-  defi_ranking: (params) => get("project/defi-ranking", params),
+  defi_ranking: (params) => get("project/defi/ranking", params),
   /** Get multiple project sub-resources in a single request. Use `fields` to select: `overview`, `token_info`, `tokenomics`, `funding`, `team`, `contracts`, `social`, `tge_status`. **Accepts project names directly** via `q` (e.g. `?q=aave`) — no need to call `/search/project` first. Also accepts UUID via `id`. Returns 404 if not found. For DeFi metrics (TVL, fees, revenue, volume, users) and per-chain breakdown, use `/project/defi/metrics`. */
   detail: (params) => get("project/detail", params)
 };
@@ -581,9 +581,9 @@ var search = {
   /** Search crypto projects by keyword. Returns matching projects with name, description, chains, and logo. */
   project: (params) => get("search/project", params),
   /** Search X (Twitter) users by keyword. Returns user profiles with handle, display name, bio, follower count, and avatar. */
-  social_people: (params) => get("search/social-people", params),
+  social_people: (params) => get("search/social/people", params),
   /** Search X (Twitter) posts by keyword or `from:handle` syntax. Returns posts with author, content, engagement metrics, and timestamp. To load more results, check `meta.has_more`; if true, pass `meta.next_cursor` as the `cursor` query parameter in the next request. */
-  social_posts: (params) => get("search/social-posts", params),
+  social_posts: (params) => get("search/social/posts", params),
   /** Search wallets by ENS name, address label, or address prefix. Returns matching wallet addresses with entity labels. */
   wallet: (params) => get("search/wallet", params),
   /** Search web pages, articles, and content by keyword. Filter by domain with `site` like `coindesk.com`. Returns titles, URLs, and content snippets. */
@@ -599,21 +599,21 @@ var social = {
   /** Get top crypto projects ranked by mindshare (social view count), sourced directly from Argus real-time data (refreshed every 5 minutes). Filter by `tag` to scope to a category (e.g. `dex`, `l1`, `meme`). Use `time_range` (`24h`, `48h`, `7d`, `30d`) to control the ranking window. Supports `limit`/`offset` pagination. */
   ranking: (params) => get("social/ranking", params),
   /** Get smart follower count time-series for a project, sorted by date descending. Lookup by X account ID (`x_id`) or project name (`q`). The `q` parameter must be a project name (e.g. `uniswap`, `ethereum`), not a personal X handle — use `x_id` for individual accounts. Returns 404 if the project has no linked X account. */
-  smart_followers_history: (params) => get("social/smart-followers-history", params),
+  smart_followers_history: (params) => get("social/smart-followers/history", params),
   /** Returns replies/comments on a specific tweet. Lookup by `tweet_id`. */
-  tweet_replies: (params) => get("social/tweet-replies", params),
+  tweet_replies: (params) => get("social/tweet/replies", params),
   /** Get X (Twitter) posts by numeric post ID strings. Pass up to 100 comma-separated IDs via the `ids` query parameter. */
   tweets: (params) => get("social/tweets", params),
   /** Get an X (Twitter) user profile — display name, follower count, following count, and bio. Lookup by `handle` (without @). */
   user: (params) => get("social/user", params),
   /** Returns a list of followers for the specified handle on X (Twitter). Lookup by `handle` (without @). */
-  user_followers: (params) => get("social/user-followers", params),
+  user_followers: (params) => get("social/user/followers", params),
   /** Returns a list of users that the specified handle follows on X (Twitter). Lookup by `handle` (without @). */
-  user_following: (params) => get("social/user-following", params),
+  user_following: (params) => get("social/user/following", params),
   /** Get recent X (Twitter) posts by a specific user, ordered by recency. Lookup by `handle` (without @). Use `filter=original` to exclude retweets. To load more results, check `meta.has_more`; if true, pass `meta.next_cursor` as the `cursor` query parameter in the next request. */
-  user_posts: (params) => get("social/user-posts", params),
+  user_posts: (params) => get("social/user/posts", params),
   /** Returns recent replies by the specified handle on X (Twitter). Lookup by `handle` (without @). */
-  user_replies: (params) => get("social/user-replies", params)
+  user_replies: (params) => get("social/user/replies", params)
 };
 
 // src/data/categories/token.ts
@@ -635,7 +635,7 @@ var wallet = {
   /** Get full transaction history for a wallet — swaps, transfers, and contract interactions. Lookup by `address`. Filter by `chain` — supports `ethereum`, `polygon`, `bsc`, `arbitrum`, `optimism`, `avalanche`, `fantom`, `base`. */
   history: (params) => get("wallet/history", params),
   /** Get entity labels for multiple wallet addresses. Pass up to 100 comma-separated addresses via the `addresses` query parameter. Returns entity name, type, and labels per address. */
-  labels_batch: (params) => get("wallet/labels-batch", params),
+  labels_batch: (params) => get("wallet/labels/batch", params),
   /** Get a time-series of the wallet's total net worth in USD. Returns ~288 data points at 5-minute intervals covering the last 24 hours. Fixed window — no custom time range supported. */
   net_worth: (params) => get("wallet/net-worth", params),
   /** Get all DeFi protocol positions for a wallet — lending, staking, LP, and farming with token breakdowns and USD values. Lookup by `address`. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@surf-ai/sdk",
-  "version": "0.1.0",
+  "version": "0.1.4",
   "description": "Surf platform SDK — data API client, server runtime, React hooks, and database helpers",
   "type": "module",
   "exports": {
@@ -28,7 +28,7 @@
     "build": "tsup",
     "dev": "tsup --watch",
     "typecheck": "tsc --noEmit",
-    "codegen": "python3 ../../src/agent_mode/gen_sdk.py"
+    "codegen": "python3 scripts/gen_sdk.py --spec https://api.ask.surf/gateway/openapi.json"
   },
   "dependencies": {
     "express": "^4.22.0",
@@ -45,8 +45,12 @@
     "react-dom": "^19.0.0"
   },
   "peerDependenciesMeta": {
-    "react": { "optional": true },
-    "react-dom": { "optional": true }
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "tsup": "^8.0.0",