SentiSignalFinance Hub API Documentation

Finance Hub API docs hub

Base prefix: https://www.sentisignal.com/api/v1

This page is the technical umbrella for the public API suite. Product landings stay separate, but auth, quota behavior, source reality, and developer entry points are grouped here so users do not need to discover the suite through individual marketing pages only.

Source and usage reality

SentiSignal public APIs are informational data products for analytics, reporting, and application experiences. They are not execution venues, not investment advice, and not a promise of tick-level or universally real-time market coverage.

Always surface the returned date, source, and freshness fields in user-facing applications. FX is daily reference data, commodity coverage is mixed-frequency, and long-tail asset coverage should not be implied to match core symbols.

Auth and quota model

Area Suite rule
Authentication One public API key works across the suite. Send it via Authorization: Bearer YOUR_API_KEY or x-api-key.
Plans Products share one tier model. Free plans are intentionally narrow; paid plans unlock history and broader request shapes depending on product scope.
Public endpoints Lookup/catalog endpoints can stay open, but price, history, and derived intelligence endpoints use the public API auth middleware.
Playground Browser playground requests count against normal quota for non-admin users. Admin accounts bypass public request caps.
Dashboard Key management, usage, and the shared playground live at /dashboard/api.

Suite quick start

# Metals
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.sentisignal.com/api/v1/metals/price?symbol=GOLD&currencies=USD,EUR"

# FX
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.sentisignal.com/api/v1/fx/rate?base=EUR&quote=USD"

# Sentiment
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.sentisignal.com/api/v1/sentiment/daily?asset_type=crypto&symbol=BTC&start_date=2026-04-04&end_date=2026-04-04"

# Commodities
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.sentisignal.com/api/v1/commodity/price?symbol=BRENT&currency=USD"

For live browser testing, use the shared playground in /dashboard/api or the product-specific playground blocks linked below.

Product docs and playgrounds

Product Base Auth Freshness reality Links
Metals API
 /api/v1/metals Public symbol/currency lookup, API key for price/history/convert. Daily reference cadence. Gold coverage is strongest; silver/platinum/palladium use fewer official sources.
FX API
 /api/v1/fx Public currency catalog, API key for spot and history. Daily ECB/Frankfurter reference rates, not intraday trading quotes.
Commodity API
 /api/v1/commodity Public symbol catalog, API key for price and history. Mixed frequency: energy is strongest on daily data, many non-energy series remain monthly.
Sentiment API
 /api/v1/sentiment API key required for aggregate sentiment endpoints. Derived from the unified news-analysis pipeline; suited to aggregate monitoring rather than raw article redistribution.
News Search API
 /api/v1/news API key required for retrieval endpoints. Contract stays metadata-first where redistribution boundaries matter. Backed by the AI-analyzed news corpus and current search/index coverage.
MCP Server
 stdio transport Uses the same public API access model via agent-native tooling. Inherits freshness from the underlying Metals, FX, Commodity, Sentiment, and News surfaces.

Shared plan matrix

Capability Free baseline Paid baseline
Spot / latest lookups Available for core product surfaces Available
Historical ranges Usually restricted Enabled by scope/tier
Broad request shapes Tighter limits on currencies, intervals, or fields Broader request shape and quota pools
Playground volume Counts against the same request pool Counts against the same request pool

Product-specific docs remain the source of truth for exact parameter limits and response contracts. This page exists to explain the suite-level model.