Skip to main content

​
1. Get an API key

  1. Sign up at app.tranc.ai.
  2. Navigate to API Keys → Create key.
  3. Copy the key — it starts with tranc_live_sk_.
Your API key is shown once. Store it in your password manager or secrets store immediately.

​
2. Make your first request

curl -s \
  -H "Authorization: Bearer tranc_live_sk_your_key_here" \
  "https://api.tranc.ai/v1/indicator/rsi?symbol=BTC-USD&tf=5m&period=14"

​
Example response

{
  "symbol": "BTC-USD",
  "exchange": "binance",
  "timeframe": "5m",
  "as_of": "2026-04-19T12:35:00Z",
  "bar_close_age_s": 18,
  "indicator": "rsi",
  "params": { "period": 14 },
  "value": 63.4,
  "unit": "ratio_0_100",
  "signal": "neutral",
  "context": {
    "prev": 59.1,
    "change_abs": 4.3,
    "percentile_7d": null,
    "range_1h": null
  },
  "hint_for_llm": "RSI at 63.4 — approaching overbought territory but not yet there. Momentum is building.",
  "compute_ms": 2,
  "cached": true,
  "stale": false
}

​
3. Use it in your agent

Paste the hint_for_llm value directly into your agent’s reasoning context: 
import httpx

resp = httpx.get(
    "https://api.tranc.ai/v1/indicator/rsi",
    params={"symbol": "BTC-USD", "tf": "5m", "period": 14},
    headers={"Authorization": "Bearer tranc_live_sk_..."}
)
data = resp.json()

# Safe to use: always check stale first
if data["stale"]:
    return "Market data is stale — cannot generate signal."

hint = data["hint_for_llm"]
# → "RSI at 63.4 — approaching overbought territory but not yet there."

​
4. Install the CLI (optional)

# macOS (Homebrew)
brew install tranc-ai/tap/tranc

# Other platforms: download from GitHub Releases
# https://github.com/tranc-ai/tranc-backend/releases

tranc auth login          # browser-based OAuth
tranc rsi BTC-USD --tf 5m

​
Next steps