FinBrain API Overview

This reference documents all available endpoints in the FinBrain v2 REST API. Use this documentation to integrate FinBrain data into your applications, trading systems, and research workflows.

Base URL

All API requests are made to:

https://api.finbrain.tech/v2/

Authentication

The v2 API supports four authentication methods. The Authorization header is recommended.

Authorization Header (Recommended)

Authorization: Bearer YOUR_API_KEY

X-API-Key Header

X-API-Key: YOUR_API_KEY

Query Parameter

?apiKey=YOUR_API_KEY

Legacy Query Parameter

?token=YOUR_API_KEY

See Authentication for details.

Available Endpoints

The FinBrain API delivers 12 alternative datasets plus discovery, screener, and recent-activity endpoints. See the Datasets Overview for the conceptual catalog.

Discovery and Reference

Endpoint	Method	Description
/v2/tickers	GET	List available tickers
/v2/markets	GET	List available markets
/v2/regions	GET	List markets grouped by region

Per-Ticker Endpoints

Government & Regulatory

Endpoint	Method	Description
/v2/congress/house/{symbol}	GET	US House member trades from STOCK Act filings
/v2/congress/senate/{symbol}	GET	US Senate member trades from STOCK Act filings
/v2/lobbying/{symbol}	GET	Federal lobbying disclosure filings
/v2/government-contracts/{symbol}	GET	Federal contract awards

Social & Consumer Intelligence

Endpoint	Method	Description
/v2/sentiment/{symbol}	GET	AI-generated news sentiment scores
/v2/news/{symbol}	GET	Recent news articles with sentiment
/v2/linkedin/{symbol}	GET	LinkedIn employee and follower metrics
/v2/app-ratings/{symbol}	GET	iOS and Android app ratings
/v2/reddit-mentions/{symbol}	GET	Reddit mentions across investing subreddits

Market & Trading Signals

Endpoint	Method	Description
/v2/predictions/{type}/{symbol}	GET	Price forecasts with confidence intervals
/v2/analyst-ratings/{symbol}	GET	Wall Street ratings and price targets
/v2/put-call-ratio/{symbol}	GET	Options put/call ratios and flow
/v2/insider-trading/{symbol}	GET	SEC Form 4 insider transactions

Screeners (Cross-Ticker)

Screen any dataset across all available tickers. See Stock Screener for full reference.

Endpoint	Description
/v2/screener/predictions/daily	Screen daily price forecasts
/v2/screener/predictions/monthly	Screen monthly price forecasts
/v2/screener/sentiment	Screen news sentiment scores
/v2/screener/news	Screen news articles
/v2/screener/analyst-ratings	Screen analyst ratings
/v2/screener/put-call-ratio	Screen put/call ratios
/v2/screener/insider-trading	Screen insider trades
/v2/screener/congress/house	Screen House member trades
/v2/screener/congress/senate	Screen Senate member trades
/v2/screener/lobbying	Screen corporate lobbying filings
/v2/screener/government-contracts	Screen government contract awards
/v2/screener/linkedin	Screen LinkedIn metrics
/v2/screener/app-ratings	Screen app ratings
/v2/screener/reddit-mentions	Screen Reddit mentions

Recent Activity

Retrieve the most recent entries across all tickers without specifying a symbol. See Recent Activity for full reference.

Endpoint	Description
/v2/recent/news	Most recent news articles
/v2/recent/analyst-ratings	Most recent analyst ratings

Request Format

URL Parameters

Parameter	Description	Example
{symbol}	Stock or asset symbol	AAPL, TSLA, BTC-USD
{type}	Prediction type	daily, monthly

Query Parameters

Parameter	Required	Description
apiKey	Yes (if not using header auth)	Your API key
startDate	No	Start date (YYYY-MM-DD)
endDate	No	End date (YYYY-MM-DD)
limit	No	Maximum number of results to return
market	No	Filter by market (e.g., NASDAQ, S&P 500)
region	No	Filter by region (e.g., US, Global)

Example Request

cURL

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.finbrain.tech/v2/predictions/daily/AAPL"

Python

import requests

url = "https://api.finbrain.tech/v2/predictions/daily/AAPL"
headers = {"Authorization": "Bearer YOUR_API_KEY"}

response = requests.get(url, headers=headers)
data = response.json()

JavaScript

const response = await fetch(
  "https://api.finbrain.tech/v2/predictions/daily/AAPL",
  { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
);
const data = await response.json();

Response Format

All responses are returned as JSON using a standardized envelope.

Success Response

{
  "success": true,
  "data": {
    // ... endpoint-specific data
  },
  "meta": {
    "timestamp": "2026-01-17T12:00:00.000Z"
  }
}

Error Response

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable message"
  }
}

HTTP Status Codes

Code	Meaning
200	Success
400	Bad Request - Invalid parameters
401	Unauthorized - Invalid API key
403	Forbidden - Access denied
404	Not Found - Data not found
429	Too Many Requests - Rate limit exceeded
500	Internal Server Error

See Error Codes for detailed error documentation.

Rate Limiting

Rate limits are enforced per API key. The following headers are included in every response:

Header	Description
X-RateLimit-Limit	Maximum requests allowed in the current window
X-RateLimit-Remaining	Requests remaining in the current window
X-RateLimit-Reset	Unix timestamp when the rate limit window resets

Rate Limit Tiers

Plan	Rate Limit
Terminal + API + MCP	2,000 requests/hour
Enterprise	Higher limits or unlimited usage, negotiated per agreement

API access is available on the Terminal + API + MCP plan and above. The Terminal-only plan does not include API access. Enterprise clients receive elevated rate limits or fully unlimited usage based on their agreement, alongside dedicated support and custom data delivery options.

When you exceed the rate limit, the API returns a 429 Too Many Requests status. Wait until the time indicated by X-RateLimit-Reset before retrying.

SDKs and Libraries

For easier integration, use our official SDK:

• Python SDK - pip install finbrain-python
• MCP Integration - pip install finbrain-mcp

Next Steps

• Authentication - Learn about API authentication
• Available Markets - Discover available markets
• Price Forecasts - Get price forecasts
• Error Codes - Handle errors properly