Developer API
The Tapeline Stock Data API
One 0–100 scoreand six sub-scores per US stock, as read-only JSON. Key-authenticated, versioned, and quota-metered — the same numbers behind the app and the public scorecard, delivered as a stable contract you can build on.
Quickstart
Create a key at /app/api-keys (Premium), then authenticate every request with an X-API-Key header (or Authorization: Bearer tl_live_…). The base URL is https://api.tapeline.io.
Example request
curl -H "X-API-Key: tl_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
"https://api.tapeline.io/api/v1/signals?min_score=70&limit=50"Example response (illustrative values)
{
"count": 50,
"limit": 50,
"offset": 0,
"items": [
{
"symbol": "AAPL",
"name": "Apple Inc.",
"sector": "Technology",
"asset_class": "equity",
"score": 79.1,
"signal": "STRONG SETUP",
"price": 231.40,
"change_pct_1d": 0.8,
"change_pct_5d": 2.1,
"change_pct_1m": 5.3,
"confidence_pct": 94,
"sub_trend": 82,
"sub_rs": 75,
"sub_fundamentals": 79,
"sub_momentum": 71,
"sub_macro": 60,
"sub_smart_money": 88,
"updated_at": "2026-06-06T13:00:00+00:00"
}
]
}Endpoints
All endpoints are GET, read-only, and return JSON. Versioned under /api/v1— fields are added, never renamed or removed, without a version bump.
/api/v1/meYour key's identity + live daily quota (limit, used today, remaining). Call it before a batch run to check your budget.
/api/v1/signalsThe full scored universe, sorted by score descending. Each row carries the composite score, descriptive signal label, price action, confidence, and all six sub-scores.
- limit
- rows to return, max 2000 (default 1000)
- offset
- pagination offset (default 0)
- min_score
- only return rows scoring at or above this (0-100)
- signal
- filter by descriptive label, e.g. "HIGH CONVICTION"
/api/v1/ticker/{symbol}One ticker's current score, signal, price action, confidence, and the six sub-scores. 404 if the symbol isn't in the scored universe.
/api/v1/regimeCurrent macro-regime snapshot — VIX, DXY, 10Y yield, rate direction, breadth, and sector leaders. The same inputs that feed the 15% macro pillar of every score.
Access & quota
- 1,000 requests/day on Premium (the trial is capped at 100/day). Check live remaining quota any time with
GET /api/v1/me. - Scores are descriptive, not advice. The exact 6-factor formula is public at /how-it-works.
- Stable contract.A 0–100 score, a descriptive signal label (HIGH CONVICTION → WEAK), and the six sub-scores per symbol — the same surface the public scorecard is built on.
Frequently asked
What is the Tapeline API?
+
A read-only, versioned REST API that returns the same scores you see in the app as JSON: one 0-100 composite score, a descriptive signal label, price action, a confidence percentage, and the six sub-scores (trend, relative strength, fundamentals, momentum, macro, smart money) for the full scored US universe. It's the same data as the in-app and public surfaces, but as a stable contract with an SLA-able daily quota.
How do I authenticate?
+
Create a key in the app at /app/api-keys (Premium tier), then send it on every request as an X-API-Key header, or as Authorization: Bearer tl_live_.... Keys are scoped to your account and enforce the per-key daily quota.
What's the rate limit?
+
1,000 requests per day on Premium. The 14-day Premium trial is capped lower (100/day) to keep the surface abuse-resistant. Call GET /api/v1/me any time to see your live remaining quota.
Is the scoring formula documented?
+
Yes — the exact 6-factor weighted formula is public at /how-it-works. Scores are descriptive (a measurement), never prescriptive (not buy/sell advice).
Is there a free tier for the API?
+
The API itself is a Premium feature. Every new account gets a 14-day Premium trial with no credit card, so you can build and test against it before deciding. The free tier covers the in-app product (top 20 tickers, delayed), not programmatic API access.
Build on the tape.
Premium includes the API, 1,000 requests/day, and everything else. 14-day trial, no credit card.