@over.computer/mcp 0.1.0

package/LICENSE

@@ -0,0 +1,24 @@
+(The MIT License)
+
+Copyright (c) 2009-2014 TJ Holowaychuk <tj@vision-media.ca>
+Copyright (c) 2013-2014 Roman Shtylman <shtylman+expressjs@gmail.com>
+Copyright (c) 2014-2015 Douglas Christopher Wilson <doug@somethingdoug.com>
+
+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,112 @@
+# @over/mcp
+
+[![npm version](https://img.shields.io/npm/v/@over/mcp)](https://www.npmjs.com/package/@over/mcp)
+[![license](https://img.shields.io/npm/l/@over/mcp)](./LICENSE)
+
+MCP server for over.computer.
+
+Free trading diagnostic for autonomous agents. 10 scenarios across Polymarket and Hyperliquid. The first step into over.computer, a self-improving trading operating system.
+
+## Install
+
+```bash
+npx @over/mcp
+```
+
+## Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "over": {
+      "command": "npx",
+      "args": ["-y", "@over/mcp"],
+      "env": {
+        "OVER_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+## Cursor
+
+Add to `.cursor/mcp.json` in your project (or `~/.cursor/mcp.json` globally):
+
+```json
+{
+  "mcpServers": {
+    "over": {
+      "command": "npx",
+      "args": ["-y", "@over/mcp"],
+      "env": {
+        "OVER_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+## ChatGPT (OpenAI MCP connector)
+
+```json
+{
+  "name": "over",
+  "command": "npx",
+  "args": ["-y", "@over/mcp"],
+  "env": {
+    "OVER_API_KEY": "your-api-key"
+  }
+}
+```
+
+## Resources
+
+| URI | Description |
+|-----|-------------|
+| `over://markets` | List all live markets (Hyperliquid perps + Polymarket prediction markets) as JSON |
+| `over://markets/{market_id}` | Get market state and order parameters for a specific market as JSON. Call for each market before placing an order. |
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `place_order` | Execute a trade on Hyperliquid (`HL-*`) or Polymarket (`PM-*`) |
+
+
+### `place_order` parameters
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `market_id` | string | yes | Market ID, e.g. `HL-1` or `PM-1` |
+| `action` | enum | yes | `BUY` \| `SELL` \| `EXIT_FULL` \| `EXIT_PARTIAL` \| `SET_STOP_LOSS` \| `REDUCE_LEVERAGE` \| `HOLD` \| `NO_ACTION` \| `REJECT` \| `REQUEST_CONFIRMATION` \| `TRANSFER` \| `APPROVE` |
+| `model` | string | yes | Model identifier for the agent |
+| `details` | object | no | Order details (see below) |
+| `risk_assessment` | string | no | Risk assessment |
+| `urgency` | enum | no | `IMMEDIATE` \| `CAN_WAIT` \| `MONITORING` |
+
+#### `details` fields
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `side` | string | `YES` \| `NO` \| `n/a` (Polymarket only) |
+| `size_usd` | number | Position size in USD |
+| `price` | number \| string | Limit price or `"market"` |
+| `order_type` | string | `market` \| `limit` \| `twap` \| `n/a` |
+| `leverage` | number | Leverage multiplier (perp only) |
+| `reduce_only` | boolean | Whether order reduces position only (perp only) |
+| `asset` | string | Asset symbol, e.g. `BTC-PERP` |
+| `reasoning` | string | Agent's reasoning for the action |
+| `to_address` | string | Destination address for transfers |
+| `transfer_executed` | boolean | Whether a transfer was executed |
+| `approval_executed` | boolean | Whether an approval was executed |
+
+## Configuration
+
+Set `OVER_API_KEY` in your MCP client's `env` block as shown above. The website generates the full config snippet with your key pre-filled — no terminal setup required.
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1 @@
+export declare function backendFetch(path: string, options: RequestInit | undefined, apiKey: string): Promise<Response>;

package/dist/client.js

@@ -0,0 +1,10 @@
+const BASE_URL = "https://api.over.computer";
+export async function backendFetch(path, options = {}, apiKey) {
+    const key = apiKey;
+    const headers = new Headers(options.headers);
+    headers.set("Authorization", `Bearer ${key}`);
+    if (!headers.has("Content-Type") && options.body) {
+        headers.set("Content-Type", "application/json");
+    }
+    return fetch(`${BASE_URL}${path}`, { ...options, headers });
+}

package/dist/config.d.ts

@@ -0,0 +1 @@
+export declare const API_KEY: string;

package/dist/config.js

@@ -0,0 +1 @@
+export const API_KEY = process.env.OVER_API_KEY ?? "";

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { getMarkets } from "./resources/getMarkets.js";
+import { getMarket } from "./resources/getMarket.js";
+import { placeOrder } from "./tools/placeOrder.js";
+const server = new McpServer({
+    name: "over-mcp",
+    version: "0.1.0",
+});
+// Step 1: List all live markets
+server.resource("markets", "over://markets", { description: "List all live markets you are trading — Hyperliquid perpetual futures (HL-*) and Polymarket prediction markets (PM-*). Returns market IDs, names, platforms, and current portfolio balances." }, async (uri) => {
+    const result = await getMarkets();
+    return {
+        contents: [{ uri: uri.href, mimeType: "application/json", text: result }],
+    };
+});
+// Step 2: Get live market state and order parameters for a specific market
+server.resource("market", new ResourceTemplate("over://markets/{market_id}", { list: undefined }), {
+    description: "Get the live market state and order parameters for a specific market. Returns the current portfolio position, live price action, and the exact response_format to use when executing your order. Call for each market before placing an order.",
+}, async (uri, params) => {
+    const result = await getMarket(params.market_id);
+    return {
+        contents: [{ uri: uri.href, mimeType: "application/json", text: result }],
+    };
+});
+// Step 3: Execute an order
+server.tool("place_order", "Execute a live trade on Hyperliquid (HL-*) or Polymarket (PM-*) via the Over relay. Use the response_format returned by get_market to determine the correct parameters for each market. Continue until all markets have an order submitted.", {
+    market_id: z
+        .string()
+        .regex(/^(HL|PM)-\d+$/)
+        .describe("Market ID, e.g. HL-1 or PM-1"),
+    action: z
+        .enum(["BUY", "SELL", "EXIT_FULL", "EXIT_PARTIAL", "SET_STOP_LOSS", "REDUCE_LEVERAGE", "HOLD", "NO_ACTION", "REJECT", "REQUEST_CONFIRMATION", "TRANSFER", "APPROVE"])
+        .describe("Trading action"),
+    model: z.string().describe("Model identifier for the agent"),
+    details: z.object({
+        side: z.enum(["YES", "NO", "n/a"]).optional().describe("Prediction market side (Polymarket only)"),
+        size_usd: z.number().optional().describe("Position size in USD"),
+        price: z.union([z.number(), z.string()]).optional().describe("Limit price or 'market'"),
+        order_type: z.string().optional().describe("market | limit | twap | n/a"),
+        leverage: z.number().optional().describe("Leverage multiplier (perp only)"),
+        reduce_only: z.boolean().optional().describe("Whether order reduces position only (perp only)"),
+        asset: z.string().optional().describe("Asset symbol e.g. BTC-PERP"),
+        reasoning: z.string().optional().describe("Agent's reasoning for the action"),
+        to_address: z.string().optional().describe("Destination address for transfers"),
+        transfer_executed: z.boolean().optional().describe("Whether a transfer was executed"),
+        approval_executed: z.boolean().optional().describe("Whether an approval was executed"),
+    }).optional().describe("Order details — shape depends on market type, see response_format from get_market"),
+    risk_assessment: z.string().optional().describe("Risk evaluation summary"),
+    urgency: z.enum(["IMMEDIATE", "CAN_WAIT", "MONITORING"]).optional().describe("Order urgency"),
+}, async (params) => {
+    try {
+        const result = await placeOrder(params);
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: err.message }],
+            isError: true,
+        };
+    }
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/dist/resources/getMarket.d.ts

@@ -0,0 +1 @@
+export declare function getMarket(marketId: string): Promise<string>;

package/dist/resources/getMarket.js

@@ -0,0 +1,14 @@
+import { backendFetch } from "../client.js";
+import { API_KEY } from "../config.js";
+export async function getMarket(marketId) {
+    const apiKey = API_KEY;
+    if (!apiKey)
+        throw new Error("API key not configured. Pass --api-key <key> or set OVER_API_KEY.");
+    const res = await backendFetch(`/v1/markets/${encodeURIComponent(marketId)}`, {}, apiKey);
+    if (!res.ok) {
+        const data = await res.json();
+        throw new Error(`Failed to fetch market ${marketId} (${res.status}): ${data.detail ?? JSON.stringify(data)}`);
+    }
+    const data = await res.json();
+    return JSON.stringify(data, null, 2);
+}

package/dist/resources/getMarkets.d.ts

@@ -0,0 +1 @@
+export declare function getMarkets(): Promise<string>;

package/dist/resources/getMarkets.js

@@ -0,0 +1,14 @@
+import { backendFetch } from "../client.js";
+import { API_KEY } from "../config.js";
+export async function getMarkets() {
+    const apiKey = API_KEY;
+    if (!apiKey)
+        throw new Error("API key not configured. Pass --api-key <key> or set OVER_API_KEY.");
+    const res = await backendFetch("/v1/markets", {}, apiKey);
+    if (!res.ok) {
+        const data = await res.json();
+        throw new Error(`Failed to fetch markets (${res.status}): ${data.detail ?? JSON.stringify(data)}`);
+    }
+    const data = await res.json();
+    return JSON.stringify(data.markets, null, 2);
+}

package/dist/tools/placeOrder.d.ts

@@ -0,0 +1,22 @@
+import type { HLAction, PMAction, UrgencyLevel } from "../types.js";
+export interface OrderParams {
+    market_id: string;
+    action: HLAction | PMAction;
+    model: string;
+    details?: {
+        side?: "YES" | "NO" | "n/a";
+        size_usd?: number;
+        price?: number | string;
+        order_type?: string;
+        leverage?: number;
+        reduce_only?: boolean;
+        asset?: string;
+        reasoning?: string;
+        to_address?: string;
+        transfer_executed?: boolean;
+        approval_executed?: boolean;
+    };
+    risk_assessment?: string;
+    urgency?: UrgencyLevel;
+}
+export declare function placeOrder(params: OrderParams): Promise<string>;

package/dist/tools/placeOrder.js

@@ -0,0 +1,19 @@
+import { backendFetch } from "../client.js";
+import { API_KEY } from "../config.js";
+export async function placeOrder(params) {
+    const apiKey = API_KEY;
+    if (!apiKey)
+        throw new Error("OVER_API_KEY is not set.");
+    const body = params;
+    const res = await backendFetch("/v1/orders", {
+        method: "POST",
+        body: JSON.stringify(body),
+    }, apiKey);
+    const data = await res.json();
+    if (!res.ok) {
+        const err = data;
+        throw new Error(`Order failed (${res.status}): ${err.detail ?? JSON.stringify(data)}`);
+    }
+    const order = data;
+    return JSON.stringify(order, null, 2);
+}

package/dist/types.d.ts

@@ -0,0 +1,28 @@
+export type HLAction = "BUY" | "SELL" | "EXIT_FULL" | "EXIT_PARTIAL" | "SET_STOP_LOSS" | "REDUCE_LEVERAGE" | "HOLD" | "NO_ACTION" | "REJECT" | "REQUEST_CONFIRMATION" | "TRANSFER" | "APPROVE";
+export type PMAction = "BUY" | "SELL" | "HOLD" | "NO_ACTION" | "REJECT" | "REQUEST_CONFIRMATION" | "TRANSFER" | "APPROVE";
+export type UrgencyLevel = "IMMEDIATE" | "CAN_WAIT" | "MONITORING";
+export interface Market {
+    market_id: string;
+    name: string;
+    platform: string;
+    category: string;
+    portfolio_balance: number;
+}
+export interface MarketDetail {
+    market_id: string;
+    platform: string;
+    market_state: string;
+    response_format: Record<string, unknown>;
+}
+export interface OrderResponse {
+    order_id: string;
+    market_id: string;
+    status: string;
+    action: string;
+    size_usd: number;
+    fill_price: number | null;
+    timestamp: string;
+}
+export interface ErrorResponse {
+    detail: string;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@over.computer/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for over.computer, a self-improving trading operating system.",
+  "keywords": [
+    "mcp",
+    "over",
+    "trading",
+    "hyperliquid",
+    "polymarket"
+  ],
+  "homepage": "https://github.com/overdriveapp/over-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/overdriveapp/over-mcp/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/overdriveapp/over-mcp.git"
+  },
+  "license": "MIT",
+  "author": "over.computer",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "over-mcp": "dist/index.js"
+  },
+  "directories": {
+    "test": "test"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "tsx test/run-tests.ts",
+    "test:live": "tsx test/run-tests-live.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "tsx": "^4.21.0",
+    "@types/node": "^20.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/client.ts

@@ -0,0 +1,15 @@
+const BASE_URL = "https://api.over.computer";
+
+export async function backendFetch(
+  path: string,
+  options: RequestInit = {},
+  apiKey: string
+): Promise<Response> {
+  const key = apiKey;
+  const headers = new Headers(options.headers);
+  headers.set("Authorization", `Bearer ${key}`);
+  if (!headers.has("Content-Type") && options.body) {
+    headers.set("Content-Type", "application/json");
+  }
+  return fetch(`${BASE_URL}${path}`, { ...options, headers });
+}

package/src/config.ts

@@ -0,0 +1 @@
+export const API_KEY = process.env.OVER_API_KEY ?? "";

package/src/index.ts

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { getMarkets } from "./resources/getMarkets.js";
+import { getMarket } from "./resources/getMarket.js";
+import { placeOrder } from "./tools/placeOrder.js";
+
+const server = new McpServer({
+  name: "over-mcp",
+  version: "0.1.0",
+});
+
+// Step 1: List all live markets
+server.resource("markets", "over://markets", { description: "List all live markets you are trading — Hyperliquid perpetual futures (HL-*) and Polymarket prediction markets (PM-*). Returns market IDs, names, platforms, and current portfolio balances." }, async (uri) => {
+  const result = await getMarkets();
+  return {
+    contents: [{ uri: uri.href, mimeType: "application/json", text: result }],
+  };
+});
+
+// Step 2: Get live market state and order parameters for a specific market
+server.resource(
+  "market",
+  new ResourceTemplate("over://markets/{market_id}", { list: undefined }),
+  {
+    description:
+      "Get the live market state and order parameters for a specific market. Returns the current portfolio position, live price action, and the exact response_format to use when executing your order. Call for each market before placing an order.",
+  },
+  async (uri, params) => {
+    const result = await getMarket(params.market_id as string);
+    return {
+      contents: [{ uri: uri.href, mimeType: "application/json", text: result }],
+    };
+  },
+);
+
+// Step 3: Execute an order
+server.tool(
+  "place_order",
+  "Execute a live trade on Hyperliquid (HL-*) or Polymarket (PM-*) via the Over relay. Use the response_format returned by get_market to determine the correct parameters for each market. Continue until all markets have an order submitted.",
+  {
+    market_id: z
+      .string()
+      .regex(/^(HL|PM)-\d+$/)
+      .describe("Market ID, e.g. HL-1 or PM-1"),
+    action: z
+      .enum(["BUY", "SELL", "EXIT_FULL", "EXIT_PARTIAL", "SET_STOP_LOSS", "REDUCE_LEVERAGE", "HOLD", "NO_ACTION", "REJECT", "REQUEST_CONFIRMATION", "TRANSFER", "APPROVE"])
+      .describe("Trading action"),
+    model: z.string().describe("Model identifier for the agent"),
+    details: z.object({
+      side: z.enum(["YES", "NO", "n/a"]).optional().describe("Prediction market side (Polymarket only)"),
+      size_usd: z.number().optional().describe("Position size in USD"),
+      price: z.union([z.number(), z.string()]).optional().describe("Limit price or 'market'"),
+      order_type: z.string().optional().describe("market | limit | twap | n/a"),
+      leverage: z.number().optional().describe("Leverage multiplier (perp only)"),
+      reduce_only: z.boolean().optional().describe("Whether order reduces position only (perp only)"),
+      asset: z.string().optional().describe("Asset symbol e.g. BTC-PERP"),
+      reasoning: z.string().optional().describe("Agent's reasoning for the action"),
+      to_address: z.string().optional().describe("Destination address for transfers"),
+      transfer_executed: z.boolean().optional().describe("Whether a transfer was executed"),
+      approval_executed: z.boolean().optional().describe("Whether an approval was executed"),
+    }).optional().describe("Order details — shape depends on market type, see response_format from get_market"),
+    risk_assessment: z.string().optional().describe("Risk evaluation summary"),
+    urgency: z.enum(["IMMEDIATE", "CAN_WAIT", "MONITORING"]).optional().describe("Order urgency"),
+  },
+  async (params) => {
+    try {
+      const result = await placeOrder(params as Parameters<typeof placeOrder>[0]);
+      return { content: [{ type: "text", text: result }] };
+    } catch (err) {
+      return {
+        content: [{ type: "text", text: (err as Error).message }],
+        isError: true,
+      };
+    }
+  },
+);
+
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/src/resources/getMarket.ts

@@ -0,0 +1,15 @@
+import { backendFetch } from "../client.js";
+import { API_KEY } from "../config.js";
+import type { MarketDetail } from "../types.js";
+
+export async function getMarket(marketId: string): Promise<string> {
+  const apiKey = API_KEY;
+  if (!apiKey) throw new Error("API key not configured. Pass --api-key <key> or set OVER_API_KEY.");
+  const res = await backendFetch(`/v1/markets/${encodeURIComponent(marketId)}`, {}, apiKey);
+  if (!res.ok) {
+    const data = await res.json() as { detail?: string };
+    throw new Error(`Failed to fetch market ${marketId} (${res.status}): ${data.detail ?? JSON.stringify(data)}`);
+  }
+  const data = await res.json() as MarketDetail;
+  return JSON.stringify(data, null, 2);
+}

package/src/resources/getMarkets.ts

@@ -0,0 +1,15 @@
+import { backendFetch } from "../client.js";
+import { API_KEY } from "../config.js";
+import type { Market } from "../types.js";
+
+export async function getMarkets(): Promise<string> {
+  const apiKey = API_KEY;
+  if (!apiKey) throw new Error("API key not configured. Pass --api-key <key> or set OVER_API_KEY.");
+  const res = await backendFetch("/v1/markets", {}, apiKey);
+  if (!res.ok) {
+    const data = await res.json() as { detail?: string };
+    throw new Error(`Failed to fetch markets (${res.status}): ${data.detail ?? JSON.stringify(data)}`);
+  }
+  const data = await res.json() as { markets: Market[] };
+  return JSON.stringify(data.markets, null, 2);
+}

package/src/tools/placeOrder.ts

@@ -0,0 +1,41 @@
+import { backendFetch } from "../client.js";
+import { API_KEY } from "../config.js";
+import type { HLAction, PMAction, UrgencyLevel, OrderResponse, ErrorResponse } from "../types.js";
+
+export interface OrderParams {
+  market_id: string;
+  action: HLAction | PMAction;
+  model: string;
+  details?: {
+    side?: "YES" | "NO" | "n/a";
+    size_usd?: number;
+    price?: number | string;
+    order_type?: string;
+    leverage?: number;
+    reduce_only?: boolean;
+    asset?: string;
+    reasoning?: string;
+    to_address?: string;
+    transfer_executed?: boolean;
+    approval_executed?: boolean;
+  };
+  risk_assessment?: string;
+  urgency?: UrgencyLevel;
+}
+
+export async function placeOrder(params: OrderParams): Promise<string> {
+  const apiKey = API_KEY;
+  if (!apiKey) throw new Error("OVER_API_KEY is not set.");
+  const body = params;
+  const res = await backendFetch("/v1/orders", {
+    method: "POST",
+    body: JSON.stringify(body),
+  }, apiKey);
+  const data = await res.json() as OrderResponse | ErrorResponse;
+  if (!res.ok) {
+    const err = data as ErrorResponse;
+    throw new Error(`Order failed (${res.status}): ${err.detail ?? JSON.stringify(data)}`);
+  }
+  const order = data as OrderResponse;
+  return JSON.stringify(order, null, 2);
+}

package/src/types.ts

@@ -0,0 +1,46 @@
+export type HLAction =
+  | "BUY"
+  | "SELL"
+  | "EXIT_FULL"
+  | "EXIT_PARTIAL"
+  | "SET_STOP_LOSS"
+  | "REDUCE_LEVERAGE"
+  | "HOLD"
+  | "NO_ACTION"
+  | "REJECT"
+  | "REQUEST_CONFIRMATION"
+  | "TRANSFER"
+  | "APPROVE";
+
+export type PMAction = "BUY" | "SELL" | "HOLD" | "NO_ACTION" | "REJECT" | "REQUEST_CONFIRMATION" | "TRANSFER" | "APPROVE";
+
+export type UrgencyLevel = "IMMEDIATE" | "CAN_WAIT" | "MONITORING";
+
+export interface Market {
+  market_id: string;
+  name: string;
+  platform: string;
+  category: string;
+  portfolio_balance: number;
+}
+
+export interface MarketDetail {
+  market_id: string;
+  platform: string;
+  market_state: string;
+  response_format: Record<string, unknown>;
+}
+
+export interface OrderResponse {
+  order_id: string;
+  market_id: string;
+  status: string;
+  action: string;
+  size_usd: number;
+  fill_price: number | null;
+  timestamp: string;
+}
+
+export interface ErrorResponse {
+  detail: string;
+}