Public API · v1

JSON, free, CORS-enabled.

Crypto quotes, stock fundamentals, forex rates, sentiment, and calendar — under one root. No API key for the free tier. Rate-limited at 60 requests / minute per IP.

Browse endpoints GET /api/v1 ↗

Endpoints

Rate limit

60 / min

Auth

None

Format

JSON

Quickstart

Try it in one line

curl https://tradintipstoday.com/api/v1/crypto/quote?id=bitcoin

Every endpoint returns JSON with a top-level ok flag, data payload, and meta (version, cache state, your rate-limit status). Errors return ok: false with an error object.

Crypto

4 endpoints

GET/api/v1/crypto/quotecache 5 min

Quote for a single coin — price, market cap, supply, ATH/ATL, multi-period change.

Parameters

idstringrequired— CoinGecko ID, e.g. bitcoin, ethereum, solana

Request

GET /api/v1/crypto/quote?id=bitcoin

Response

{
  "ok": true,
  "data": {
    "id": "bitcoin",
    "symbol": "BTC",
    "name": "Bitcoin",
    "rank": 1,
    "price": 104287.42,
    "marketCap": 2058372919800,
    "volume24h": 48211000000,
    "change24h": 2.41,
    "change7d": 5.13,
    ...
  },
  "meta": { "version": "v1", "cached": false, "rateLimit": { "limit": 60, "remaining": 59, "resetIn": 58 } }
}

GET/api/v1/crypto/topcache 5 min

Top coins by market cap.

Parameters

limitintdefault: 50— 1–200
pageintdefault: 1— 1–10

GET/api/v1/crypto/trendingcache 10 min

Trending coins on CoinGecko in the last 24h.

GET/api/v1/crypto/globalcache 10 min

Total crypto market cap, 24h volume, BTC/ETH dominance.

Stocks

4 endpoints

GET/api/v1/stocks/quotecache 15 min

Delayed quote (15-min delay typical) — price, change, day OHLC, previous close.

Parameters

symbolstringrequired— Ticker, e.g. AAPL, MSFT, TSLA

GET/api/v1/stocks/profilecache 24h

Company profile — industry, country, IPO date, logo, market cap, website.

Parameters

symbolstringrequired

GET/api/v1/stocks/fundamentalscache 24h

P/E, EPS, market cap, 52w high/low, beta, dividend yield, ROE.

Parameters

symbolstringrequired

GET/api/v1/stocks/tickerscache 24h

List of available tickers in our catalogue.

Parameters

qstring— Search query (symbol or name)
sectorstring— GICS sector filter
exchangestring— NASDAQ, NYSE, AMEX
limitintdefault: 200— 1–3000

Forex

2 endpoints

GET/api/v1/forex/quotecache 2h

Currency pair quote — live rate, daily range, % change.

Parameters

pairstringrequired— e.g. eur-usd or EUR/USD

GET/api/v1/forex/pairscache 24h

List of all available currency pairs with base/quote and category.

Sentiment

1 endpoint

GET/api/v1/sentiment/fear-greedcache 1h

Crypto Fear & Greed Index — current value plus historical series.

Parameters

daysintdefault: 1— 1–365

Calendar

2 endpoints

GET/api/v1/calendar/economiccache 6h

Economic events — FOMC, CPI, NFP, GDP, etc. with actual/forecast/previous.

Parameters

daysintdefault: 14— 1–30 days ahead
impactstring— high | medium | low
countrystring— ISO-2 code, e.g. US, GB, JP

GET/api/v1/calendar/earningscache 6h

Upcoming earnings with EPS estimates and revenue forecasts.

Parameters

daysintdefault: 14— 1–30 days ahead
limitintdefault: 50— 1–200

Rate limits

Free tier

Requests / min60
WindowSliding 60s
BucketPer IP
AuthNone

Hit the limit and you get a 429 with a Retry-After header.

Pro tier

10× more headroom

Requests / min600
WindowSliding 60s
BucketPer API key
AuthX-API-Key: pro_…

Plus priority data refresh and advanced filters. Join the waitlist →

Errors

Predictable shape

{
  "ok": false,
  "error": {
    "code": "MISSING_PARAM",
    "message": "...",
    "docs": "https://tradintipstoday.com/api"
  },
  "meta": { ... }
}

Fine print

Data sources & attribution

Data comes from CoinGecko, Binance, Alternative.me, Finnhub, Twelve Data, and FRED — each under their own terms. Some endpoints require server-side API keys to be configured; without them, the endpoint returns UPSTREAM_NOT_CONFIGURED. The free tier is offered as-is; we may add a paid tier for higher limits in the future. If you build something cool, a link back is appreciated.