Algo integration API specification

A small REST API for creators to register algos, stream trading signals, report health and upload backtests, plus webhooks that tell your server what subscribers executed. Version 1. Base URL https://fintrens.com/lantern/api/v1. OpenAPI 3.1 document.

Authentication

Every request carries an API key as a bearer token. Keys are scoped to one algo and one environment (sandbox or live). Rotate keys from the creator console; old keys stay valid for 24 hours.

Authorization: Bearer lk_live_9f2c… X-Lantern-Timestamp: 1760600000 X-Lantern-Signature: sha256=… # HMAC of timestamp + body with your signing secret (required for /signals)

Algos

POST/algos— register an algo (draft)

GET/algos/{algo_id}— fetch status, verification state, subscriber count

PATCH/algos/{algo_id}— update description, pricing, slots

POST/algos/{algo_id}/submit— submit for verification

POST /algos { "name": "Convex Credit Spread Overnight", "category": "non_directional", "strategy": "credit_spread", "exchange": "NSE", "instrument": "NIFTY", "segment": "FO", "holding": "overnight", "min_allocation": 100000, "max_allocation": 320000, "stop_loss_pct": 8, "pricing": { "monthly_fee": 1499, "profit_share_pct": 20, "slots": 100 }, "summary": "...", "description": "...", "faqs": [{ "q": "...", "a": "..." }] } 201 → { "algo_id": "alg_7Qp2", "status": "draft", "api_key": "lk_sandbox_…", "signing_secret": "whsec_…" }

Signals

A signal is an instruction the platform fans out to every subscriber's broker account, sized by their allocation. Multi-leg signals are atomic: either all legs are placed or none.

POST/signals— push a new entry / exit / modify signal

GET/signals/{signal_id}— fill status aggregated across subscribers

POST/signals/{signal_id}/cancel— cancel unfilled legs

POST /signals { "algo_id": "alg_7Qp2", "client_ref": "sig-2026-10-15-01", "action": "ENTRY", "ts": "2026-10-15T07:43:00Z", "valid_till": "2026-10-16T09:45:00Z", "legs": [ { "side": "SELL", "symbol": "NIFTY26O1922600PE", "exchange": "NFO", "qty_per_lot": 25, "lots_per_lakh": 0.4, "order_type": "LIMIT", "price": 176.90 }, { "side": "BUY", "symbol": "NIFTY26O1922200PE", "exchange": "NFO", "qty_per_lot": 25, "lots_per_lakh": 0.4, "order_type": "LIMIT", "price": 45.50 } ], "risk": { "stop_loss_pct": 8, "target_pct": 65, "max_slippage_bps": 25 } } 202 → { "signal_id": "sig_K1m9", "status": "queued", "subscribers": 83 }

Sizing: lots_per_lakh scales quantity to each subscriber's allocation. Exchange rules allow LIMIT orders only; MARKET is rejected. Exit signals reference the entry via parent_signal_id.

Heartbeat

POST/heartbeat— every 60 s during market hours

{ "algo_id": "alg_7Qp2", "ts": "2026-10-15T07:44:00Z", "state": "RUNNING", "open_positions": 1 }

Three missed heartbeats pause the algo for new entries and notify subscribers; open positions are managed by the platform stop-loss.

Backtests

POST/backtests— upload a trade log for verification (multipart CSV or JSON)

GET/backtests/{backtest_id}— verification result, metrics and certificate URL

The trade log uses the same template as the Create a strategy upload: one row per leg, and legs that share a trade_id form one multi-leg trade. Download the CSV template.

Column	Meaning	Example
`trade_id`	Groups legs into one trade. Legs that share a trade_id are a multi-leg trade.	`T1`
`leg`	Leg number within the trade (1, 2, 3…).	`1`
`entry_time`	Entry date and time: YYYY-MM-DD HH:MM (IST for India, ET for US stocks, UTC for crypto).	`2024-01-02 09:20`
`exit_time`	Exit date and time, same time zone: YYYY-MM-DD HH:MM.	`2024-01-02 15:15`
`exchange`	India: NSE, BSE, NFO, BFO, MCX, CDS, NCDEX or NCO. US stocks: NYSE, NASDAQ, ARCA or CBOE. Crypto: BINANCE.	`NFO`
`symbol`	Underlying or stock symbol as in the scrip master.	`NIFTY`
`instrument`	EQ (cash), FUT or OPT.	`OPT`
`expiry`	Contract expiry, YYYY-MM-DD. Blank for EQ.	`2024-01-04`
`strike`	Strike price. Options only.	`21700`
`option_type`	CE or PE. Options only.	`CE`
`side`	BUY or SELL.	`SELL`
`quantity`	Units traded (lots × lot size, or contracts × 100 for US options), positive. Crypto can be fractional.	`50`
`entry_price`	Average entry price, in ₹ for India and in $ / USDT for US stocks and crypto.	`120.50`
`exit_price`	Average exit price, same currency.	`88.30`
`charges`	Optional. Brokerage, taxes and fees for the leg, same currency.	`40`

GET /backtests/bt_3x { "status": "verified", "period": { "from": "2023-10", "to": "2026-09" }, "metrics": { "cagr": 62.5, "max_drawdown": -43.1, "sharpe": 1.19, "win_rate": 52.4, "trades": 312 }, "certificate_url": "https://fintrens.com/lantern/certificates/bt_3x.pdf" }

Webhooks (platform → creator)

Event	When
`signal.filled`	Aggregate fills for a signal reach 100% or valid_till passes
`signal.rejected`	Validation or risk check failed (reason included)
`subscriber.joined` / `subscriber.left`	Subscriber count and AUM change
`algo.paused`	Missed heartbeats, exchange halt or risk breach
`payout.settled`	Monthly subscription and profit-share payout

Marketplace read API (public)

Read-only endpoints used by white-label partners and this site's assistant. No key required; 60 requests / minute per IP.

GET/marketplace/algos— list algos with summary metrics; supports ?sort=cagr|max_drawdown|sharpe|win_rate|stop_loss&risk=&segment=

GET/marketplace/algos/{slug}— full performance page data (monthly returns, drawdowns, trades)

GET/marketplace/combine?algos=a,b,c&alloc=1,1,2— combined metrics and correlation matrix

Errors and limits

Status	Meaning
400 `validation_error`	Schema violation; `errors[]` lists fields
401 / 403	Bad key, wrong environment or signature mismatch
409 `duplicate_client_ref`	Same `client_ref` seen in the last 24 h (idempotent)
422 `risk_rejected`	Stop-loss above listed SL, or order type not allowed
429	Rate limit: 120 signals / min per algo, 600 requests / min per key

Sandbox

Sandbox keys hit https://fintrens.com/lantern/sandbox-api/v1, simulate fills against delayed market data and never reach a broker. Backtests submitted in sandbox count toward verification.

curl -X POST https://fintrens.com/lantern/sandbox-api/v1/heartbeat \ -H "Authorization: Bearer lk_sandbox_…" -H "Content-Type: application/json" \ -d '{"algo_id":"alg_7Qp2","ts":"2026-10-15T07:44:00Z","state":"RUNNING","open_positions":0}'