FinSignals
Sentiment, direction & quality classification for Reddit financial social posts.
About FinSignals
FinSignals is a REST API that classifies financial social media posts, news reactions, and headlines in a single request, returning structured JSON rather than free-form output. Each classified item receives seven signals: sentiment (positive/negative/neutral), directionality (bullish/bearish/neutral), content quality (relevant/noise/spam), post type (dd, news reaction, technical analysis, fundamentals, question, general), a relevance score, an author confidence score, and an experimental sarcasm flag. Categorical signals include a winning label plus per-class probabilities.
The API offers a single-item endpoint (POST /v1/classify) and a batch endpoint (POST /v1/classify/batch, up to 256 items per call, with a combined 128,000-character payload limit). Requests require at least one of ticker, company_name, title, or body. Usage is metered in credits: 1.00 credit per single classification, and 1.00 credit for the first item plus 0.70 credits per additional item in a batch call. Plans include a monthly credit pool, with optional pay-as-you-go balance for overages. Rate limits are applied per API key on a 60-second sliding window, with separate tiers (Free, Starter, Pro, Scale/Enterprise) governing requests per minute for single and batch endpoints.
The product targets developers building applications that need automated classification of financial text, such as trading tools, sentiment dashboards, or content-filtering systems. It provides a Python SDK (pip install finsignals-api), API key authentication via an X-API-Key header, and endpoints for checking usage/credit balance (GET /v1/usage), plan details and rate limits (GET /v1/plan), and service liveness (GET /v1/health, which does not require authentication).
Key features
- Single-post classification via POST /v1/classify
- Batch classification of up to 256 items per request via POST /v1/classify/batch
- Returns structured JSON with per-class probabilities for categorical heads
- Usage and plan endpoints to check credit balance and rate limits
- Python SDK available via pip install finsignals-api
Frequently asked questions
Is there a free tier?
Yes, there is a free account tier with a rate limit of 5 requests per minute for single classification and 2 per minute for batch classification.
How is usage billed?
Usage is metered in credits: single classify costs 1.00 credit per call, and batch classify costs 1.00 credit for the first item plus 0.70 credits for each additional item in that request.
What languages or SDKs are supported?
FinSignals provides a Python SDK installable via pip install finsignals-api, and the API can also be called directly via REST with curl.
How is authentication handled?
Every request except GET /v1/health must include an API key in the X-API-Key header, obtained after creating a free account.
Is the sarcasm detection reliable?
The sarcasm signal is still experimental, so it should be treated as directional rather than ground truth until validated on your own data.
Show your product to thousands of developers
· 100k monthly pageviews
· 7k newsletter subscribers
You might also like
Financial Modeling Prep
FinanceRealtime and historical stock data.
FinFeedAPI
FinanceDeveloper-first market data API.
Finnhub
FinanceReal-Time RESTful APIs and Websocket for Stocks, Currencies, and Crypto.
Finturest IBAN
FinanceFast, accurate IBAN validation and generation.
FRED
FinanceEconomic data from the Federal Reserve Bank of St. Louis.
Front Accounting APIs
FinanceFront accounting is multilingual and multicurrency software for small businesses.
