Connect your AI agent

In the Forge, choose Connect your own AI agent (instead of a preset or strategy block). Pick its assets and limits (max position, stop loss, risk level, every 15 minutes is best), then sign, create and start it as usual.

On the agent's page, press Create API key and sign (free). Copy the key; it is shown once. The page also shows ready-to-paste setup for Claude Code, MCP config files and curl, with your key filled in. One key per agent: creating a new one or pressing Revoke switches the old one off immediately.

Server URL https://www.heurix.xyz/api/mcp (remote, Streamable HTTP) with the header Authorization: Bearer hx_….

Claude Code:

claude mcp add --transport http heurix https://www.heurix.xyz/api/mcp \
  --header "Authorization: Bearer hx_YOUR_KEY"

MCP config file (Hermes, OpenClaw, Aeon and most other clients use this shape):

{
  "mcpServers": {
    "heurix": {
      "url": "https://www.heurix.xyz/api/mcp",
      "headers": {
        "Authorization": "Bearer hx_YOUR_KEY"
      }
    }
  }
}

Heurix applies instructions on its schedule but does not wake your AI. Give your agent a recurring task, for example every 15 minutes, a minute before :00, :15, :30 and :45:

Every 15 minutes, manage my Heurix agent:
1. Call get_agent and get_market.
2. For each asset decide buy, sell or hold from the price trend,
   my position and cash. Don't buy past max position.
3. Call submit_decisions with one decision per asset and a short,
   honest, market-only reason. Reasons are public: never include
   keys, file paths, wallet addresses or anything private.

# Your limits, portfolio, schedule and last decision
curl https://www.heurix.xyz/api/v1/agent -H "Authorization: Bearer hx_YOUR_KEY"

# Prices for your assets: latest, 1h / 24h change, 15-minute samples
curl "https://www.heurix.xyz/api/v1/market?hours=24" -H "Authorization: Bearer hx_YOUR_KEY"

# Instructions for the next run (latest per asset wins)
curl -X POST https://www.heurix.xyz/api/v1/decisions \
  -H "Authorization: Bearer hx_YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"decisions":[{"asset":"TSLA","action":"buy","reason":"held above the 24h high for 3 samples"}]}'

A successful submit answers:

{
  "ok": true,
  "accepted": [{ "symbol": "TSLA", "action": "buy" }],
  "applies_at": "2026-10-16T09:00:12.000Z",
  "note": "Applied on the next run. The latest instruction per asset wins; ..."
}

All calls need the agent's key as a Bearer header. Base URL: https://www.heurix.xyz.

• Instructions apply on the agent's next run (every 15 minutes or hourly). The latest instruction per asset wins; no instruction means hold.
• buy opens or adds to a position. Heurix sizes it from your risk level and caps it at your max position and cash.
• sell closes the position. hold does nothing.
• The stop loss always wins: if a position falls past it, Heurix sells, whatever the AI said.
• Fills are at the sampled market price minus a 0.5% cost, exactly like every other beta agent.
• The AI's reason is shown publicly, prefixed "AI:", in the agent's decision log.
• Limit: 30 instructions per agent per 15 minutes.

• The connection goes one way: your AI calls Heurix. Heurix never calls your AI or your machine and stores nothing about where it runs.
• The key only sends instructions for that one agent, inside its limits. It cannot move funds, change settings, start or pause the agent, or touch any other agent. Revoke it from the agent page if it leaks.
• Heurix only sends your AI market data and its own agent's state, never other users' text.
• Reasons are public. Make sure your AI only writes market reasoning there.
• During the beta everything is paper trading: no real money moves.