Search for a command to run...
Loading...
Embed SimTrade's AI signals, portfolio engine, and backtester into your apps or AI agents via our MCP server or REST API.
Sign in to manage your API keys and view your usage.
All API requests require your SimTrade API key. Pass it in the X-SimTrade-API-Key header (or as a Bearer token in Authorization).
curl https://simtrade.io/api/mcp \
-H "X-SimTrade-API-Key: sk_simtrade_YOUR_KEY_HERE"API keys are available on Pro ($19/mo) and higher plans. View plans →
SimTrade ships a Model Context Protocol server at https://simtrade.io/api/mcp. Any MCP-compatible AI client (Claude, Cursor, etc.) can call SimTrade tools directly.
get_signalsAI-generated BUY/SELL/HOLD signals for AAPL, TSLA, NVDA, MSFT, GOOGL with live prices.
Returns
{ signals: [{symbol, action, confidence, currentPrice, targetPrice, stopLoss}], generatedAt }analyze_portfolioPaper trading portfolio: balance, total value, P&L, and the 10 most recent trades.
Returns
{ balance, totalValue, pnl, pnlPercent, recentTrades[] }run_backtestSMA 20/50 crossover backtest on any ticker over a custom date range.
Parameters
cURL
# List available tools
curl -s https://simtrade.io/api/mcp \
-H "X-SimTrade-API-Key: YOUR_KEY"
# Get AI trading signals
curl -s https://simtrade.io/api/mcp \
-X POST \
-H "Content-Type: application/json" \
-H "X-SimTrade-API-Key: YOUR_KEY" \
-d '{"method":"tools/call","params":{"name":"get_signals"}}'
# Run a backtest
curl -s https://simtrade.io/api/mcp \
-X POST \
-H "Content-Type: application/json" \
-H "X-SimTrade-API-Key: YOUR_KEY" \
-d '{
"method": "tools/call",
"params": {
"name": "run_backtest",
"arguments": {
"symbol": "NVDA",
"start_date": "2024-01-01",
"end_date": "2024-12-31",
"initial_capital": 10000
}
}
}'Python
import requests
SIMTRADE_API_KEY = "YOUR_KEY"
MCP_URL = "https://simtrade.io/api/mcp"
def call_tool(name, arguments=None):
resp = requests.post(
MCP_URL,
headers={
"Content-Type": "application/json",
"X-SimTrade-API-Key": SIMTRADE_API_KEY,
},
json={"method": "tools/call", "params": {"name": name, "arguments": arguments or {}}},
)
resp.raise_for_status()
return resp.json()
# Get trading signals
signals = call_tool("get_signals")
print(signals)
# Backtest NVDA over 2024
result = call_tool("run_backtest", {
"symbol": "NVDA",
"start_date": "2024-01-01",
"end_date": "2024-12-31",
})
print(f"Total return: {result['content'][0]['text']}")TypeScript / JavaScript
const SIMTRADE_API_KEY = process.env.SIMTRADE_API_KEY!
const MCP_URL = "https://simtrade.io/api/mcp"
async function callTool(name: string, args?: Record<string, unknown>) {
const res = await fetch(MCP_URL, {
method: "POST",
headers: {
"Content-Type": "application/json",
"X-SimTrade-API-Key": SIMTRADE_API_KEY,
},
body: JSON.stringify({
method: "tools/call",
params: { name, arguments: args ?? {} },
}),
})
if (!res.ok) throw new Error(`SimTrade MCP error: ${res.status}`)
return res.json()
}
// Usage
const { content } = await callTool("get_market_quote", { symbol: "BTC" })
const quote = JSON.parse(content[0].text)
console.log(`BTC price: $${quote.price}`)API calls consume credits from your account. Credits are deducted only on success. Buy more at /credits.
| Tool | Credits |
|---|---|
get_signals | 5 |
analyze_portfolio | 6 |
run_backtest | 8 |
get_market_quote | 5 |
API access is included on Pro and higher plans. Get your API key from account settings after upgrading.
symbolstringrequirede.g. AAPL, BTC-USD, SPYstart_datestringrequiredYYYY-MM-DDend_datestringrequiredYYYY-MM-DDinitial_capitalnumberoptionalDefault 10000Returns
{ totalReturn, winRate, maxDrawdown, sharpeRatio, totalTrades }get_market_quoteLive price quote for any stock or crypto ticker via Yahoo Finance / Alpha Vantage.
Parameters
symbolstringrequirede.g. AAPL, BTC, ETHReturns
{ symbol, price, change24hPct, volume, source }