CryptoLinkDocs

v2.0.0public60 symbols

Crypto market data and lightweight analytics signals

Base URL
https://cryptolink-production.up.railway.app
Quick curl
code
curl -s "https://cryptolink-production.up.railway.app/v1/prices?symbols=BTC,ETH&fiat=MXN"
Nota: en producción agrega header x-api-key.
Quickstart
  • Base URL
  • Authentication with x-api-key
  • REST examples for direct market data and derived signals
  • Default display currency is USD. Pass fiat to override.
Signals
  • CryptoLink includes direct data, derived signals, and interpretive layers.
  • Available signal families include Trends, Movers, Momentum, Regime, Risk Flags, Anomalies, and Market Health.
Endpoints
  • Direct endpoints return market data.
  • Derived endpoints return internal analytics signals.
  • Interpretive endpoints return health, risk, and anomaly views.
Plans & Limits
  • Plan limits are enforced by symbol count.
  • Typical client errors include 400, 401, and 429 responses.
Errors & Debugging
  • Use X-Request-Id for support and debugging flows.
  • Retry logic is recommended for transient 5xx responses.
Endpoints
GET/v1/price• Single price
Query params
name
required
example / notes
symbol
yes
BTC— Single asset symbol.
fiat
no
USD— Display currency. Default: USD.
Examples
curl
code
curl -s "https://cryptolink-production.up.railway.app/v1/price?symbol=BTC&fiat=USD" \
  -H "x-api-key: TU_API_KEY"
Responses
200 — OK
code
{"ts":".......","ok":true,"source":".....","marketCap":1583962661795.2954,"price":78852.0,"symbol":"BTC","change24h":1.9696273628936847,"fiat":"USD"}
401 — Missing or invalid API key
400 — Invalid symbol or request format
429 — Rate limit exceeded
GET/v1/prices• Prices by symbols
Query params
name
required
example / notes
symbols
yes
BTC,ETH— CSV list, no spaces.
fiat
no
USD— Display currency. Default: USD.
Examples
curl
code
curl -s "https://cryptolink-production.up.railway.app/v1/prices?symbols=BTC,ETH&fiat=USD" \
  -H "x-api-key: TU_API_KEY"
Responses
200 — OK
code
{"marketCap":{"BTC":1584127244458.4119,"ETH":309104894066.60004},"change24h":{"BTC":1.982788636074705,"ETH":0.9509427550316462},"prices":{"BTC":78882.0,"ETH":2530.93},"ok":true,"source":"...","fiat":"USD","ts":"..."}
401 — Missing or invalid API key
400 — Invalid symbols or plan symbol limit exceeded
429 — Rate limit exceeded
GET/v1/snapshot• Market snapshot
Query params
name
required
example / notes
symbols
no
BTC,ETH,SOL— Optional symbol set.
fiat
no
USD— Display currency. Default: USD.
Examples
curl
code
curl -s "https://cryptolink-production.up.railway.app/v1/snapshot?symbols=BTC,ETH,SOL&fiat=USD" \
  -H "x-api-key: TU_API_KEY"
Responses
200 — OK
code
{"snapshot":{"source":"...","asOf":"...","prices":{"BTC":79003.0,"ETH":2533.94},"fiat":"USD","provider":"...","marketMood":"neutral"},"ok":true}
GET/v1/trends• Trends
Query params
name
required
example / notes
symbols
yes
BTC,ETH,SOL— CSV list of assets.
fiat
no
USD— Display currency. Default: USD.
Examples
curl
code
curl -s "https://cryptolink-production.up.railway.app/v1/trends?symbols=BTC,ETH,SOL&fiat=USD" \
  -H "x-api-key: TU_API_KEY"
Responses
200 — Derived trend signals
code
{"ok":true,"trends":[{"symbol":"BTC","direction":"up","changePct":0.26,"score":0.26,"last":79130.00,"source":"price-history-db"},
          {"symbol":"SOL","direction":"up","changePct":0.25,"score":0.25,"last":102.95,"source":"price-history-db"},
          {"symbol":"ETH","direction":"flat","changePct":0.19,"score":0.19,"last":2537.03,"source":"price-history-db"}],"source":"internal-history","ts":"...","fiat":"USD"}
GET/v1/movers• Movers
Query params
name
required
example / notes
symbols
yes
BTC,ETH,SOL— CSV list of assets.
fiat
no
USD— Display currency. Default: USD.
limit
no
3— Maximum movers returned per side.
Examples
curl
code
curl -s "https://cryptolink-production.up.railway.app/v1/movers?symbols=BTC,ETH,SOL&fiat=USD&limit=3" \
  -H "x-api-key: TU_API_KEY"
Responses
200 — Relative movers
code
{"ok":true,"fiat":"USD","ts":"...","source":"internal-history","gainers":[],"losers":[]}
GET/v1/momentum• Momentum
Query params
name
required
example / notes
symbols
yes
BTC,ETH,SOL— CSV list of assets.
fiat
no
USD— Display currency. Default: USD.
Examples
curl
code
curl -s "https://cryptolink-production.up.railway.app/v1/momentum?symbols=BTC,ETH,SOL&fiat=USD" \
  -H "x-api-key: TU_API_KEY"
Responses
200 — Momentum signal read
code
{"ok":true,"momentum":[{"symbol":"SOL","direction":"up","changePct":0.56,"strength":"medium","score":0.37,"last":103.42,"source":"price-history-db"},
          {"symbol":"BTC","direction":"up","changePct":0.31,"strength":"low","score":0.15,"last":79127.00,"source":"price-history-db"},
          {"symbol":"ETH","direction":"up","changePct":0.19,"strength":"low","score":0.08,"last":2538.34,"source":"price-history-db"}],
          "source":"internal-history","ts":"...","fiat":"USD"}
GET/v1/regime• Market regime
Query params
name
required
example / notes
symbols
yes
BTC,ETH,SOL— CSV list of assets.
fiat
no
USD— Display currency. Default: USD.
Examples
curl
code
curl -s "https://cryptolink-production.up.railway.app/v1/regime?symbols=BTC,ETH,SOL&fiat=USD" \
  -H "x-api-key: TU_API_KEY"
Responses
200 — Aggregate market regime
code
{"ok":true,"regime":{"ok":true,"regime":{"state":"bullish","score":1.40,"confidence":0.93,"summary":"A strong bullish lean with high confidence — 3 of 3 leaning up."},
          "source":"internal-analysis","ts":"...","fiat":"USD"}
GET/v1/risk-flags• Risk flags
Query params
name
required
example / notes
symbols
yes
BTC,ETH,SOL— CSV list of assets.
fiat
no
USD— Display currency. Default: USD.
Examples
curl
code
curl -s "https://cryptolink-production.up.railway.app/v1/risk-flags?symbols=BTC,ETH,SOL&fiat=USD" \
  -H "x-api-key: TU_API_KEY"
Responses
200 — Interpretive risk layer
code
{"source":"internal-analysis","summary":"3 risk flags active, 1 at medium severity — worth a closer look.","ok":true,"fiat":"USD","flags":
          [{"code":"low_confidence_regime","severity":"medium","title":"Low regime confidence","detail":"The neutral regime reads at only 16% confidence, so directional signals are weakly supported."},
          {"code":"weak_momentum","severity":"low","title":"Weak momentum","detail":"All 3 tracked assets show low momentum strength — little conviction behind current moves."},
          {"code":"flat_market","severity":"low","title":"No clear direction","detail":"2 of 3 trend signals are flat — the group is holding without a clear direction."}],"ts":"..."}
GET/v1/anomalies• Anomalies
Query params
name
required
example / notes
symbols
yes
BTC,ETH,SOL— CSV list of assets.
fiat
no
USD— Display currency. Default: USD.
Examples
curl
code
curl -s "https://cryptolink-production.up.railway.app/v1/anomalies?symbols=BTC,ETH,SOL&fiat=USD" \
  -H "x-api-key: TU_API_KEY"
Responses
200 — Anomaly detection layer
code
{"source":"internal-analysis","summary":"1 signal drifting outside the recent pattern, none extreme.","anomalies":
          [{"symbol":"SOL","type":"momentum_spike","severity":"medium","score":2.38,"detail":
          "SOL is running clearly ahead of the group on momentum, about 2.38x the group average."}],"ok":true,"fiat":"USD","ts":"..."}
GET/v1/market-health• Market health
Query params
name
required
example / notes
symbols
yes
BTC,ETH,SOL— CSV list of assets.
fiat
no
USD— Display currency. Default: USD.
Examples
curl
code
curl -s "https://cryptolink-production.up.railway.app/v1/market-health?symbols=BTC,ETH,SOL&fiat=USD" \
  -H "x-api-key: TU_API_KEY"
Responses
200 — Executive market condition layer
code
{"marketHealth":{"state":"healthy","score":94,"summary":"Conditions look healthy — driven by a bullish regime and 1 anomaly."},
          "ok":true,"source":"internal-analysis","ts":"....","fiat":"USD"}
updated: 2026-09-14