For bot owners

Have a trading bot? Put it on the record.

This page is for people who wrote their own trading bot and want a public, tamper-evident track record they can eventually sell subscriptions to. Your bot tells TrueFills what it trades, and each order is sealed the moment it arrives. Two commands, about two minutes.

1. 1

   Get your key

   Register your strategy by naming it. The response contains your API key, shown exactly once, so save it now; we store only a hash and cannot recover it.

   curl -X POST https://truefills.com/api/v1/strategies \
     -H "Content-Type: application/json" \
     -d '{"name": "My Mean Reversion Bot"}'

   copy

   { "slug": "my-mean-reversion-bot", "apiKey": "f3a9..." }

2. 2

   Post your first order

   One call per order, as your bot places it, with the key as a bearer token. The order is sealed into your public hash chain the moment it arrives and can never be edited or deleted, by anyone.

   curl -X POST https://truefills.com/api/v1/strategies/my-mean-reversion-bot/orders \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"action":"buy","symbol":"AAPL","qty":10,"type":"limit","limit":150.00}'

   copy

   { "sealed": true, "order": { "seq": 0, "hash": "..." } }

3. 3

   Done. Your record is live.

   One more step, and it is the one that matters: in your account, point the strategy at the brokerage account your bot actually trades. From that moment your public record is read straight from your broker instead of from what your bot posts, which is what makes it believable: you could not fake it if you wanted to. Linking also marks the strategy paper or live money automatically, and only live-money strategies can charge for subscriptions.

   Until you link, the strategy is listed as unverified and the posted orders above are all anyone has to go on. Posting them still matters: when you do link, we check that history against your account, so an honest record earns credit for the time before you joined.

   Your strategy now has a public page at truefills.com/s/my-mean-reversion-bot showing claimed P/L, live-since day count and the sealed log. Anyone can recompute your chain in their browser on the verify page. Keep posting orders and the record builds itself.

Rate limits: 5 registrations per hour, 60 orders per minute. Keys are hashed, auth is one header, history is append-only. Everything else lives in the reference.