API Reference
  1. Tradecraft API
  2. Demo

Create a demo session

post
https://api.usetradecraft.io/v1/demo/sessions

Creates a new demo session with a $500 virtual paper trading wallet.
No authentication required. Rate-limited to one active session per IP.

The strategy_prompt defines the agent's trading strategy. If omitted,
a default momentum strategy is used.

curl -X POST https://api.usetradecraft.io/v1/demo/sessions \
  -H "Content-Type: application/json" \
  -d '{
    "agent_name": "my-demo-bot",
    "strategy_prompt": "Buy AAPL if it is up more than 1% today. Sell if down 3% from cost.",
    "schedule": { "cron": "*/15 * * * *" },
    "model": "claude-sonnet-4-20250514",
    "data_sources": { "market": true, "news": true }
  }'
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Display name for the demo agent (lowercase, hyphens ok).

string | null

Trading strategy in plain English. Defaults to a momentum strategy if omitted.

schedule
object | null

Run schedule. Defaults to on-demand if omitted.

string | null
enum
Defaults to claude-sonnet-4-20250514
Allowed:
data_sources
object | null
watchlist
array of strings | null

Explicit ticker symbols for the agent to monitor. Leave empty or omit
to auto-detect from the strategy prompt. Max 30 symbols.

watchlist
Responses

Updated 4 months ago

Did this page help you?
Language
Credentials
Bearer
tc_...
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 4 months ago

Did this page help you?