cURL
#!/bin/sh
# placeOrder: Place a limit order. Needs TRENDLINE_API_KEY; TRENDLINE_API_BASE overrides the base.
curl -sS -X POST "${TRENDLINE_API_BASE:-https://systems.trendlinelabs.ai}/public/v1/orders" \
-H "Authorization: Bearer $TRENDLINE_API_KEY" \
-H "Content-Type: application/json" -d '{"venue":"polymarket","universal_id":"mk-btc-100k-2026","outcome":"yes","side":"buy","type":"limit","price":"0.42","size":10,"client_order_id":"s1-0001"}'"""placeOrder: Place a limit order. Needs TRENDLINE_API_KEY; TRENDLINE_API_BASE overrides the base."""
import os
import requests
BASE = os.environ.get("TRENDLINE_API_BASE", "https://systems.trendlinelabs.ai")
KEY = os.environ["TRENDLINE_API_KEY"]
r = requests.post(f"{BASE}/public/v1/orders", json={"venue": "polymarket", "universal_id": "mk-btc-100k-2026", "outcome": "yes", "side": "buy", "type": "limit", "price": "0.42", "size": 10, "client_order_id": "s1-0001"},
headers={"Authorization": f"Bearer {KEY}"}, timeout=10)
print(r.status_code, r.json())
// placeOrder: Place a limit order. Needs TRENDLINE_API_KEY; TRENDLINE_API_BASE overrides the base.
const BASE = process.env.TRENDLINE_API_BASE ?? "https://systems.trendlinelabs.ai";
const KEY = process.env.TRENDLINE_API_KEY;
const r = await fetch(`${BASE}/public/v1/orders`, { method: "POST", headers: { Authorization: `Bearer ${KEY}`, "Content-Type": "application/json" }, body: JSON.stringify({"venue":"polymarket","universal_id":"mk-btc-100k-2026","outcome":"yes","side":"buy","type":"limit","price":"0.42","size":10,"client_order_id":"s1-0001"}) });
console.log(r.status, await r.json());
{
"avg_price": null,
"client_order_id": "s1-0001",
"created_at": "2026-10-06T05:59:59+00:00",
"filled_size": "0",
"id": "ord_6702291f8e1c2a0012ab34cd",
"notional_reserved": "4.20",
"outcome": "yes",
"price": "0.42",
"remaining_size": "10",
"side": "buy",
"size": 10,
"status": "open",
"time_in_force": "gtc",
"type": "limit",
"universal_id": "mk-btc-100k-2026",
"updated_at": "2026-10-06T05:59:59+00:00",
"venue": "polymarket",
"venue_market_id": "bitcoin-above-100k-on-december-31",
"venue_market_title": "Bitcoin above $100,000 on December 31?",
"venue_order_id": "0x5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e"
}{
"client_order_id": "<string>",
"created_at": "<string>",
"id": "<string>",
"notional_reserved": "<string>",
"outcome": "<string>",
"price": "<string>",
"side": "buy",
"size": 123,
"status": "open",
"time_in_force": "gtc",
"type": "limit",
"universal_id": "<string>",
"updated_at": "<string>",
"venue": "kalshi",
"venue_market_id": "<string>",
"avg_price": "<string>",
"filled_size": "<string>",
"remaining_size": "<string>",
"venue_market_title": "<string>",
"venue_order_id": "<string>"
}{
"client_order_id": "<string>",
"created_at": "<string>",
"id": "<string>",
"notional_reserved": "<string>",
"outcome": "<string>",
"price": "<string>",
"side": "buy",
"size": 123,
"status": "open",
"time_in_force": "gtc",
"type": "limit",
"universal_id": "<string>",
"updated_at": "<string>",
"venue": "kalshi",
"venue_market_id": "<string>",
"avg_price": "<string>",
"filled_size": "<string>",
"remaining_size": "<string>",
"venue_market_title": "<string>",
"venue_order_id": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}Trading
Place a limit order
Beta: not yet enabled; the launch venues are Polymarket, predict.fun and Limitless (Kalshi comes later). Requests answer 404 with {"detail": "Not Found"}, as an unregistered path does, until trading is switched on. Place one limit order with your own connected venue account, on a venue enabled for trading. Every order gets our `id` (ord_...) the moment we accept it. Send a client_order_id you generate; resending the same request with it never places a second order (the latest answer is replayed with Idempotent-Replay: true). 201: the venue accepted it. 202 status unknown: the venue's answer was not received; retry the SAME request (same client_order_id) or read GET /public/v1/orders/{id}, and it is reconciled from the venue, never re-submitted; where the venue cannot prove an order's absence the answer can stay unknown, so check the venue's own listing before trading the same intent again. 200: an answer a reconcile produced (the venue's state, or status not_placed). price is the price of `outcome`, 0..1 on the venue's grid, refused (never rounded) when off it. Refusals: 503 trading_halted; 403 trade_not_granted, jurisdiction_refused, trading_tier_required; 422 venue_unsupported, price_off_tick, limit_exceeded, venue_rejected, invalid_request; 404 not_found, venue_not_listed, venue_not_connected; 410 market_closed; 409 venue_leg_unverified, idempotency_conflict, request_in_progress (Retry-After), venue_auth_failed; 429 rate_limited; 503 venue_unavailable, dependency_unavailable.
POST
/
public
/
v1
/
orders
cURL
#!/bin/sh
# placeOrder: Place a limit order. Needs TRENDLINE_API_KEY; TRENDLINE_API_BASE overrides the base.
curl -sS -X POST "${TRENDLINE_API_BASE:-https://systems.trendlinelabs.ai}/public/v1/orders" \
-H "Authorization: Bearer $TRENDLINE_API_KEY" \
-H "Content-Type: application/json" -d '{"venue":"polymarket","universal_id":"mk-btc-100k-2026","outcome":"yes","side":"buy","type":"limit","price":"0.42","size":10,"client_order_id":"s1-0001"}'"""placeOrder: Place a limit order. Needs TRENDLINE_API_KEY; TRENDLINE_API_BASE overrides the base."""
import os
import requests
BASE = os.environ.get("TRENDLINE_API_BASE", "https://systems.trendlinelabs.ai")
KEY = os.environ["TRENDLINE_API_KEY"]
r = requests.post(f"{BASE}/public/v1/orders", json={"venue": "polymarket", "universal_id": "mk-btc-100k-2026", "outcome": "yes", "side": "buy", "type": "limit", "price": "0.42", "size": 10, "client_order_id": "s1-0001"},
headers={"Authorization": f"Bearer {KEY}"}, timeout=10)
print(r.status_code, r.json())
// placeOrder: Place a limit order. Needs TRENDLINE_API_KEY; TRENDLINE_API_BASE overrides the base.
const BASE = process.env.TRENDLINE_API_BASE ?? "https://systems.trendlinelabs.ai";
const KEY = process.env.TRENDLINE_API_KEY;
const r = await fetch(`${BASE}/public/v1/orders`, { method: "POST", headers: { Authorization: `Bearer ${KEY}`, "Content-Type": "application/json" }, body: JSON.stringify({"venue":"polymarket","universal_id":"mk-btc-100k-2026","outcome":"yes","side":"buy","type":"limit","price":"0.42","size":10,"client_order_id":"s1-0001"}) });
console.log(r.status, await r.json());
{
"avg_price": null,
"client_order_id": "s1-0001",
"created_at": "2026-10-06T05:59:59+00:00",
"filled_size": "0",
"id": "ord_6702291f8e1c2a0012ab34cd",
"notional_reserved": "4.20",
"outcome": "yes",
"price": "0.42",
"remaining_size": "10",
"side": "buy",
"size": 10,
"status": "open",
"time_in_force": "gtc",
"type": "limit",
"universal_id": "mk-btc-100k-2026",
"updated_at": "2026-10-06T05:59:59+00:00",
"venue": "polymarket",
"venue_market_id": "bitcoin-above-100k-on-december-31",
"venue_market_title": "Bitcoin above $100,000 on December 31?",
"venue_order_id": "0x5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e5e"
}{
"client_order_id": "<string>",
"created_at": "<string>",
"id": "<string>",
"notional_reserved": "<string>",
"outcome": "<string>",
"price": "<string>",
"side": "buy",
"size": 123,
"status": "open",
"time_in_force": "gtc",
"type": "limit",
"universal_id": "<string>",
"updated_at": "<string>",
"venue": "kalshi",
"venue_market_id": "<string>",
"avg_price": "<string>",
"filled_size": "<string>",
"remaining_size": "<string>",
"venue_market_title": "<string>",
"venue_order_id": "<string>"
}{
"client_order_id": "<string>",
"created_at": "<string>",
"id": "<string>",
"notional_reserved": "<string>",
"outcome": "<string>",
"price": "<string>",
"side": "buy",
"size": 123,
"status": "open",
"time_in_force": "gtc",
"type": "limit",
"universal_id": "<string>",
"updated_at": "<string>",
"venue": "kalshi",
"venue_market_id": "<string>",
"avg_price": "<string>",
"filled_size": "<string>",
"remaining_size": "<string>",
"venue_market_title": "<string>",
"venue_order_id": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "<string>"
}
}Authorizations
Authorization: Bearer tl_live_…
Body
application/json
an id you choose for this order (e.g. a UUID), unique per order; resend the same one only to retry the same order, which never places a second order
Pattern:
^[A-Za-z0-9_-]{1,64}$the venue's own outcome label the order is on
Available options:
yes, no the limit price of outcome, a plain decimal string; a price off the venue's grid is refused, never rounded
Required string length:
1 - 32Pattern:
^[0-9]+(\.[0-9]+)?$buy or sell, the action on outcome at price
Available options:
buy, sell whole contracts
Required range:
1 <= x <= 1000000the order type; only limit
Allowed value:
"limit"the venue to trade on; only venues enabled for trading are accepted (no best-venue routing)
Available options:
kalshi, polymarket, limitless, predictfun gtc rests until cancelled, ioc fills what it can now and cancels the rest
Available options:
gtc, ioc the market universal id; its leg on venue is traded, so switching venue is one field. Send this, venue_market_id, or both
Required string length:
1 - 256the venue's own market id (on Kalshi, its ticker); with universal_id both must name the same leg, else 422, never re-routed
Required string length:
1 - 256Response
a reconcile's answer (the venue's state, or not_placed), or a replay of the latest answer for this client_order_id
your id for this order
when we accepted the order, ISO 8601
our id for the order, ord_ and 24 hex digits; it exists from the moment we accept the request, so an order whose status is unknown has one too
Pattern:
^ord_[0-9a-f]{24}$the order's maximum loss counted against your limits, USD as a decimal string
the venue's own outcome label
the limit price of outcome, a decimal string
buy or sell, the action on outcome at price
Available options:
buy, sell whole contracts ordered
unknown: the venue's answer was not received; retry with the same client_order_id or read GET /public/v1/orders/{id}, never send a new id. On a venue that cannot prove an order's absence it may stay unknown: check the venue before trading the same intent again
Available options:
open, filled, partially_filled, cancelled, unknown, not_placed as requested
Available options:
gtc, ioc the order type; only limit
Allowed value:
"limit"the market universal id holding the leg; null when no market lists it
when we last recorded a change to the order, ISO 8601
the venue the order was sent to
Available options:
kalshi, polymarket, limitless, predictfun the venue's own market id the order went to
the average fill price of outcome, 0..1 as a decimal string, when the venue reported one
contracts filled, an exact decimal string; null while the status is unknown
contracts still resting, an exact decimal string; null while the status is unknown
the leg's title on the venue, when our mirror holds it
the venue's order id; null while the status is unknown and for an order that was never placed