System R AI Docs

Web app

No installation needed for the web app. Sign up to use the Agentic Trading Workspace:

app.systemr.ai

Python SDK

Requirements

Python 3.9 or higher
pip (or any PEP 517 installer)

Install

pip install systemr

The package installs one dependency: httpx for HTTP requests.

Import

from systemr import SystemRClient

For error handling:

from systemr import (
    SystemRClient,
    SystemRError,
    InsufficientBalanceError,
    AuthenticationError,
)

Initialize the client

client = SystemRClient(api_key="sr_agent_...")

Constructor parameters

Parameter	Type	Default	Description
`api_key`	str	Required	Your agent API key (starts with `sr_agent_`).
`base_url`	str	`https://agents.systemr.ai`	API base URL. Override for local development.
`timeout`	float	`30.0`	Request timeout in seconds.

Custom base URL

For local development or self-hosted deployments:

client = SystemRClient(
    api_key="sr_agent_...",
    base_url="http://localhost:8000",
)

Context manager

The client supports Python's context manager protocol for automatic cleanup:

with SystemRClient(api_key="sr_agent_...") as client:
    result = client.pre_trade_gate(
        symbol="AAPL",
        direction="long",
        entry_price="185.50",
        stop_price="180.00",
        equity="100000",
    )
    print(result)
# HTTP connection is closed automatically

Or close manually:

client = SystemRClient(api_key="sr_agent_...")
# ... use client ...
client.close()

Error handling

from systemr import SystemRClient, InsufficientBalanceError, AuthenticationError, SystemRError
 
client = SystemRClient(api_key="sr_agent_...")
 
try:
    result = client.pre_trade_gate(
        symbol="AAPL",
        direction="long",
        entry_price="185.50",
        stop_price="180.00",
        equity="100000",
    )
except AuthenticationError:
    print("Invalid API key or agent is not active")
except InsufficientBalanceError:
    print("Deposit compute credits to continue")
except SystemRError as e:
    print(f"API error ({e.status_code}): {e.detail}")

Error types

Exception	HTTP Status	Meaning
`AuthenticationError`	401	Invalid or missing API key.
`AuthenticationError`	403	Agent is suspended or terminated.
`InsufficientBalanceError`	402	Compute credit balance too low.
`SystemRError`	4xx/5xx	All other API errors.

Using raw REST calls

You do not need the SDK. Any HTTP client works:

import httpx
 
resp = httpx.post(
    "https://agents.systemr.ai/v1/tools/call",
    headers={"X-API-Key": "sr_agent_..."},
    json={
        "tool_name": "calculate_position_size",
        "arguments": {
            "equity": "100000",
            "entry_price": "185.50",
            "stop_price": "180.00",
            "direction": "long",
        },
    },
)
 
print(resp.json())

curl -X POST https://agents.systemr.ai/v1/tools/call \
  -H "X-API-Key: sr_agent_..." \
  -H "Content-Type: application/json" \
  -d '{
    "tool_name": "calculate_position_size",
    "arguments": {
      "equity": "100000",
      "entry_price": "185.50",
      "stop_price": "180.00",
      "direction": "long"
    }
  }'

Authentication

Every authenticated request requires the X-API-Key header:

X-API-Key: sr_agent_abc123def456...

The SDK handles this automatically. If you use raw HTTP, include the header in every request.

Public machine-readable endpoints include:

GET /v1/openapi.json
GET /.well-known/agent.json
GET /.well-known/mcp/server-card.json

Current API Toolkit capabilities are described in the docs and machine readable agent metadata. Developers should use the documented MCP, SDK, REST, and OpenAPI surfaces that are live and valid. Authenticated API and billing endpoints require the access path described in the docs.

System R AI

Python SDK	`pip install systemr`
MCP Server	agents.systemr.ai/mcp/sse
OpenAPI Spec	agents.systemr.ai/v1/openapi.json
Machine Docs	agents.systemr.ai/llms.txt
GitHub	System-R-AI
X	@Systemrai
YouTube	@systemr_ai
Email	hello@systemr.ai
Phone	`628 333 6693`
Address	`7901 4TH ST N, STE 28529, ST PETERSBURG, FL 33702`
Terms	Terms of Service
Privacy	Privacy Policy
Security	Security Policy

Install

On this page