Developer Documentation

Tahlil Plus API Documentation

Technical documentation for Crypto API, Stock API and Forex API: authentication, plans, limits, symbol discovery, utility endpoints, response headers, errors and endpoint usage examples.

Crypto APIStock APIForex APIBearer Auth

API Overview →View Pricing

Documentation Layer

Integration-ready reference

Docs

Auth

Bearer Key

Format

JSON

Markets

3 APIs

Limits

Plan-based

Integration Coverage

Authentication95.00

Endpoint Coverage92.00

Usage Controls90.00

Authentication

Bearer API Key

Authorization header required

Markets

3 APIs

Crypto, stock and forex endpoints

Responses

JSON

Chart-friendly and object-based formats

Limits

Plan-based

Rate and history access controls

Overview

API overview

Tahlil Plus provides multiple market data APIs for pricing, charting, symbol discovery and data workflows. The current public price API family includes Crypto API, Stock API and Forex API.

Analyst and prediction intelligence APIs are a separate product layer and should remain conceptually separate from raw price APIs.

Authentication

Bearer API key authentication

Protected endpoints require an API key in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Missing or invalid keys return authentication errors such as MISSING_API_KEY or INVALID_API_KEY.

Base URLs

Dedicated API base URLs

API	Base URL	Purpose
Crypto API	https://crypto-api.tahlil-plus.dk	Crypto prices, history, symbol discovery and market metrics.
Stock API	https://stock-api.tahlil-plus.dk	Stock prices, history, symbol discovery and chart data.
Forex API	https://forex-api.tahlil-plus.dk	Forex prices, history, symbol discovery and chart data.

Plans

Plans and access limits

Access limits depend on the selected plan. Plans define request volume and maximum historical access depth.

Plan	Requests / Minute	Requests / Day	Requests / Month	History Access
Free	60	1,000	20,000	7 days
Starter	120	10,000	200,000	90 days
Pro	300	100,000	2,000,000	730 days
Enterprise	1000	1,000,000	20,000,000	3650 days

Internal admin or development keys may expose larger limits than public plans. Public integrations should follow official plan limits.

Rate Limits

Minute, day and month usage windows

Rate limits are enforced on multiple windows: per-minute requests, per-day requests and per-month requests. If a request exceeds allowed usage, the API may return RATE_LIMIT_EXCEEDED.

Minute

Short-window protection

Day

Daily usage control

Month

Plan-level quota

History Limits

Historical access depends on plan

Historical requests are restricted by plan. If the requested range exceeds your plan access, the API may return HISTORY_LIMIT_EXCEEDED.

Invalid or reversed time ranges may return INVALID_TIME_RANGE or another validation error.

Symbols

Symbol discovery endpoints

GET /search

Search symbols by query text.

GET /symbols

Get metadata for one symbol.

GET /symbol_info

Return bulk symbol metadata.

/symbol_info can return very large payloads depending on the API and symbol universe.

Utility

Utility endpoints

GET /health

Returns API service health status.

GET /time

Returns current server UNIX time.

GET /config

Returns supported capabilities and metadata.

GET /usage

Returns plan limits, usage and remaining quota.

Usage

Usage endpoint response

The /usage endpoint returns current plan, configured limits, usage counters, remaining counters and reset timing.

{
  "ok": true,
  "status": "ok",
  "compact": false,
  "plan": "pro",
  "limits": {
    "minute": 300,
    "day": 100000,
    "month": 2000000,
    "max_history_days": 730
  },
  "usage": {
    "minute": 12,
    "day": 751,
    "month": 8883
  },
  "remaining": {
    "minute": 288,
    "day": 99249,
    "month": 1991117
  }
}

Response Format

Standard JSON and chart responses

Standard data endpoints usually return fields such as ok, status, symbol, price, compact and divisor.

Chart endpoints return array-based candle responses using TradingView-style fields such as t, o, h, l, c and v.

Headers

Rate limit response headers

Header	Meaning
X-RateLimit-Limit-Minute	Maximum allowed requests in current minute window
X-RateLimit-Remaining-Minute	Remaining requests in current minute window
X-RateLimit-Limit-Day	Maximum allowed requests in current day window
X-RateLimit-Remaining-Day	Remaining requests in current day window
X-RateLimit-Limit-Month	Maximum allowed requests in current month window
X-RateLimit-Remaining-Month	Remaining requests in current month window

HTTP/1.1 200 OK
X-RateLimit-Limit-Minute: 300
X-RateLimit-Remaining-Minute: 299
X-RateLimit-Limit-Day: 100000
X-RateLimit-Remaining-Day: 99249
X-RateLimit-Limit-Month: 2000000
X-RateLimit-Remaining-Month: 1991117

Compact Metrics

Compact crypto market metrics

Selected internal crypto market metric symbols can return compact numeric responses by default:

TOTALTOTAL2TOTAL3OTHERS

{
  "ok": true,
  "status": "ok",
  "symbol": "TOTAL",
  "price": 2.77,
  "compact": true,
  "divisor": 1000000000000,
  "compact_detail": {
    "price": {
      "raw": 2773292602696.2803,
      "display": "2.77T",
      "suffix": "T",
      "unit_name": "trillion"
    }
  }
}

Errors

Error codes

Error Code	HTTP Code	Meaning
MISSING_PARAMETER	400	Required parameter is missing
INVALID_PARAMETER	400	Parameter value is invalid
INVALID_TIMESTAMP	400	Timestamp is invalid
INVALID_RESOLUTION	400	Resolution is not supported
INVALID_RANGE	400	Requested range is invalid
SYMBOL_NOT_FOUND	404	Symbol not found
UNSUPPORTED_SYMBOL	400	Symbol is not supported
NO_DATA_AVAILABLE	404	No data available
PROVIDER_ERROR	502	External provider error
PROVIDER_TIMEOUT	504	External provider timeout
PROCESSING_ERROR	500	Failed to process request
INTERNAL_ERROR	500	Internal server error
SERVICE_UNAVAILABLE	503	Service temporarily unavailable
MISSING_API_KEY	401	API key is missing
INVALID_API_KEY	401	API key is invalid
RATE_LIMIT_EXCEEDED	429	Rate limit exceeded
HISTORY_LIMIT_EXCEEDED	403	Requested range is outside plan history access
INVALID_TIME_RANGE	400	Invalid time range
FORBIDDEN	403	Access denied

Crypto API

Crypto API reference

Crypto API supports runtime Binance-listed crypto symbols and internal crypto market metrics such as TOTAL, TOTAL2, TOTAL3 and OTHERS.

https://crypto-api.tahlil-plus.dk

GET

GET /search?query=BTC&limit=5

Find symbols by text query.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://crypto-api.tahlil-plus.dk/search?query=BTC&limit=5"

GET

Symbols

GET /symbols?symbol=BTCUSDT

Return metadata for one specific symbol.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://crypto-api.tahlil-plus.dk/symbols?symbol=BTCUSDT"

GET

Symbol Info

GET /symbol_info

Return bulk metadata for available symbols.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://crypto-api.tahlil-plus.dk/symbol_info"

GET

Current Price

GET /current_price?symbol=BTCUSDT

Return the latest available price for the requested symbol.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://crypto-api.tahlil-plus.dk/current_price?symbol=BTCUSDT"

GET

Time Price

GET /time_price?symbol=BTCUSDT&timestamp=UNIX_TS

Return point-in-time price for the requested symbol.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://crypto-api.tahlil-plus.dk/time_price?symbol=BTCUSDT&timestamp=UNIX_TS"

GET

History

GET /history?symbol=BTCUSDT&resolution=60&from=START_TS&to=END_TS

Return historical candles in chart-friendly format.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://crypto-api.tahlil-plus.dk/history?symbol=BTCUSDT&resolution=60&from=START_TS&to=END_TS"

GET

Time High Low

GET /time_high_low?symbol=BTCUSDT&from=START_TS&to=END_TS

Return one aggregated high/low summary for a range.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://crypto-api.tahlil-plus.dk/time_high_low?symbol=BTCUSDT&from=START_TS&to=END_TS"

GET

Daily High Low

GET /daily_high_low?symbol=BTCUSDT&from=START_TS&to=END_TS

Return daily grouped high/low values.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://crypto-api.tahlil-plus.dk/daily_high_low?symbol=BTCUSDT&from=START_TS&to=END_TS"

GET

Hourly High Low

GET /hourly_high_low?symbol=BTCUSDT&from=START_TS&to=END_TS

Return hourly grouped high/low values.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://crypto-api.tahlil-plus.dk/hourly_high_low?symbol=BTCUSDT&from=START_TS&to=END_TS"

Stock API

Stock API reference

Stock API provides stock symbol discovery, current prices, historical candles and grouped high/low endpoints.

https://stock-api.tahlil-plus.dk

GET

GET /search?query=AAPL&limit=5

Find symbols by text query.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://stock-api.tahlil-plus.dk/search?query=AAPL&limit=5"

GET

Symbols

GET /symbols?symbol=AAPL

Return metadata for one specific symbol.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://stock-api.tahlil-plus.dk/symbols?symbol=AAPL"

GET

Symbol Info

GET /symbol_info

Return bulk metadata for available symbols.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://stock-api.tahlil-plus.dk/symbol_info"

GET

Current Price

GET /current_price?symbol=AAPL

Return the latest available price for the requested symbol.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://stock-api.tahlil-plus.dk/current_price?symbol=AAPL"

GET

Time Price

GET /time_price?symbol=AAPL&timestamp=UNIX_TS

Return point-in-time price for the requested symbol.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://stock-api.tahlil-plus.dk/time_price?symbol=AAPL&timestamp=UNIX_TS"

GET

History

GET /history?symbol=AAPL&resolution=60&from=START_TS&to=END_TS

Return historical candles in chart-friendly format.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://stock-api.tahlil-plus.dk/history?symbol=AAPL&resolution=60&from=START_TS&to=END_TS"

GET

Time High Low

GET /time_high_low?symbol=AAPL&from=START_TS&to=END_TS

Return one aggregated high/low summary for a range.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://stock-api.tahlil-plus.dk/time_high_low?symbol=AAPL&from=START_TS&to=END_TS"

GET

Daily High Low

GET /daily_high_low?symbol=AAPL&from=START_TS&to=END_TS

Return daily grouped high/low values.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://stock-api.tahlil-plus.dk/daily_high_low?symbol=AAPL&from=START_TS&to=END_TS"

GET

Hourly High Low

GET /hourly_high_low?symbol=AAPL&from=START_TS&to=END_TS

Return hourly grouped high/low values.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://stock-api.tahlil-plus.dk/hourly_high_low?symbol=AAPL&from=START_TS&to=END_TS"

Forex API

Forex API reference

Forex API provides currency pair discovery, current prices, historical candles and grouped range endpoints.

https://forex-api.tahlil-plus.dk

GET

GET /search?query=EURUSD&limit=5

Find symbols by text query.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://forex-api.tahlil-plus.dk/search?query=EURUSD&limit=5"

GET

Symbols

GET /symbols?symbol=EURUSD

Return metadata for one specific symbol.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://forex-api.tahlil-plus.dk/symbols?symbol=EURUSD"

GET

Symbol Info

GET /symbol_info

Return bulk metadata for available symbols.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://forex-api.tahlil-plus.dk/symbol_info"

GET

Current Price

GET /current_price?symbol=EURUSD

Return the latest available price for the requested symbol.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://forex-api.tahlil-plus.dk/current_price?symbol=EURUSD"

GET

Time Price

GET /time_price?symbol=EURUSD&timestamp=UNIX_TS

Return point-in-time price for the requested symbol.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://forex-api.tahlil-plus.dk/time_price?symbol=EURUSD&timestamp=UNIX_TS"

GET

History

GET /history?symbol=EURUSD&resolution=60&from=START_TS&to=END_TS

Return historical candles in chart-friendly format.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://forex-api.tahlil-plus.dk/history?symbol=EURUSD&resolution=60&from=START_TS&to=END_TS"

GET

Time High Low

GET /time_high_low?symbol=EURUSD&from=START_TS&to=END_TS

Return one aggregated high/low summary for a range.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://forex-api.tahlil-plus.dk/time_high_low?symbol=EURUSD&from=START_TS&to=END_TS"

GET

Daily High Low

GET /daily_high_low?symbol=EURUSD&from=START_TS&to=END_TS

Return daily grouped high/low values.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://forex-api.tahlil-plus.dk/daily_high_low?symbol=EURUSD&from=START_TS&to=END_TS"

GET

Hourly High Low

GET /hourly_high_low?symbol=EURUSD&from=START_TS&to=END_TS

Return hourly grouped high/low values.

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://forex-api.tahlil-plus.dk/hourly_high_low?symbol=EURUSD&from=START_TS&to=END_TS"