developers

Our data, in your agent.

A REST API and an MCP server for unusual Polymarket activity and our paper engine's positions. One key works for both. Included with every paid plan.

your api key

Checking your session…

authentication

One key, two headers

Send your key as Authorization: Bearer st_... or x-api-key: st_.... A missing or invalid key returns 401. A key on a free plan returns 402 with a link to pricing. AI Signals keys get 10,000 requests per UTC day; Edge and Lifetime are unlimited. Limits are enforced per server instance, so treat them as approximate. Responses include X-RateLimit-* headers and CORS is open, so browser apps can call the API directly.

rest api

Endpoints

Base URL https://www.stockautotrader.com. All responses are JSON.

GET/api/v1/predictions

Polymarket markets with unusual activity right now, ranked by 24h volume, volume spike against the market's lifetime daily average, and 24h price move.

params · limit (1-100, default 25), flag (volume_spike | big_move | whale_market | closing_soon)

GET/api/v1/paper-positions

Positions from our Polymarket paper engine. Simulated: synthetic capital at live prices, no real money. Every response carries "simulated": true.

params · status (open | closed, default open), limit (1-200, default 50)

GET/api/v1/me

Your plan and today's request count, limit and reset time.

params · none

curl

curl -H "Authorization: Bearer YOUR_KEY" \
  "https://www.stockautotrader.com/api/v1/predictions?limit=10&flag=volume_spike"

curl -H "x-api-key: YOUR_KEY" \
  "https://www.stockautotrader.com/api/v1/paper-positions?status=closed&limit=20"

curl -H "Authorization: Bearer YOUR_KEY" "https://www.stockautotrader.com/api/v1/me"

Prediction fields

question, url, outcome	Market question, Polymarket link, and the outcome the price refers to
price	Current price of that outcome, 0 to 1
change24h	24h price change, in price units
volume24h, volumeTotal, liquidity	USD, as reported by Polymarket
spike	24h volume divided by the market's lifetime average daily volume
flags	Any of volume_spike, big_move, whale_market, closing_soon
score	Our ranking score; higher is more unusual

Market data comes from Polymarket's public API; the ranking is ours. Paper positions are simulated trades from our own engine, not a record of real-money results.

mcp server

Plug it into your agent

Streamable HTTP at https://www.stockautotrader.com/api/mcp. Tools: get_unusual_predictions {limit?, flag?} and get_paper_positions {status?, limit?}. Only tool calls count toward your daily limit.

Claude Code

claude mcp add --transport http stockautotrader https://www.stockautotrader.com/api/mcp --header "Authorization: Bearer YOUR_KEY"

Cursor

Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project).

{
  "mcpServers": {
    "stockautotrader": {
      "type": "http",
      "url": "https://www.stockautotrader.com/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json. This uses the mcp-remote bridge so the key can travel as a header.

{
  "mcpServers": {
    "stockautotrader": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://www.stockautotrader.com/api/mcp",
        "--header", "Authorization:Bearer YOUR_KEY"
      ]
    }
  }
}

Raw JSON-RPC

curl -X POST https://www.stockautotrader.com/api/mcp \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"get_unusual_predictions","arguments":{"limit":5}}}'

access

API and MCP are included with every paid plan.

See pricing