Browse documentation
Getting started
Raspberry API turns social conversation, financial news, trader setups, official SEC filings and rules-based strategies into consistent JSON. This guide gets you from an API key to your first response in plain English.
https://raspberrytrades.comExamples, not live results. The responses in this guide are illustrative so you can understand each field. The Playground works without an account, while current data requires an API key. The insider trading page of every covered company and the NVDA guidance page are public.
Choose what you want to learn
Start with the question, not the endpoint name. Each link opens a focused guide with the request, response fields, source and limitations.
Market Intelligence
Social sentiment, multi-source news and how market mood changes over time.
Radar & Scanners
The two products that scan the market for you: breakout setups from the chart and the trusted network, and strategy matches across the universe.
Strategies
Rules-based trading systems: the library, their live signals and the historical backtest.
Account
Your keys, your quota and the private influencer lists that feed your own responses.
Company Data
Official SEC filings, insider trades, reported financials, company guidance and earnings briefs.
Product to endpoint
Which path serves each product. A product is one endpoint; the path is what you call, the name is what you read about.
| Product | Endpoint | Docs |
|---|---|---|
| Stock Sentiment | /api/sentiment | /docs/stock-sentiment |
| Market Sentiment | /api/market-sentiment | /docs/market-sentiment |
| News Sentiment | /api/news | /docs/news-sentiment |
| Market News | /api/market-news | /docs/market-news |
| Sentiment History | /api/history | /docs/sentiment-history |
| Breakout Radar | /api/radar | /docs/breakout-radar |
| Rebound Radar | /api/rebound | /docs/rebound-radar |
| Investment Strategies | /api/strategies | /docs/investment-strategies |
| Insider Trading | /api/v1/insider-trades/AAPL | /docs/insider-trading |
| Financial Statements | /api/v1/financials/AAPL | /docs/financial-statements |
| Company Guidance | /api/v1/guidance/NVDA | /docs/company-guidance |
| Earnings Brief | /api/v1/earnings-brief/NVDA | /docs/earnings-brief |
Historical path: the Breakout Radar also answers at /api/influencers, which is deprecated for the board and carries a Sunset header. Its view=accounts and view=traders stay there.
Quickstart โ your first call in 3 steps
From zero to live market sentiment in about a minute.
Make your first call
Paste your key and ask for any US ticker. Pick your language:
import requests
resp = requests.get(
"https://raspberrytrades.com/api/sentiment",
headers={"x-api-key": "ra_live_your_key_here"},
params={"ticker": "NVDA"},
)
data = resp.json()
print(data["sentiment"]["label"], data["sentiment"]["score"])Read the response
You get back clean JSON โ the overall sentiment label & score, the bullish / bearish / neutral split, and the top tweets behind it. See the full shape in Example below.
Prefer no code? Use it on TradingView
Free browser add-ons place sentiment, stock news and Breakout Radar context inside TradingView for the symbol you're viewing. They update as you switch symbols, with no coding required.
Install Tampermonkey
A free browser extension that runs small add-ons. Get it for your browser at tampermonkey.net.
Open TradingView
Open any US stock on tradingview.com and a panel appears showing whether traders on X are bullish or bearish on it, right now โ with the tweets behind it.
Developer details+
The add-on is a Tampermonkey userscript that calls /api/sentiment for the symbol shown in the TradingView tab, using your own API key (it prompts for it on first run and stores it locally in your browser โ click the ๐ in the widget to change it). Your calls count against your plan's quota.
Get an API key
An API key is like a password for your app. Create one in your dashboard and use it to access Raspberry API data. Keep your key private โ never share it publicly or post it online.
Developer details+
Your key starts with ra_live_. Treat it as a secret and keep it on your server โ never ship it in front-end code. One key works for every Raspberry API endpoint.
Connecting
Every request includes your API key so we know it's you. Add the key to your request and you're connected. If a request is missing a valid key, it simply won't return any data.
Developer details+
Send your key in the x-api-key header on every request (the ?api_key= query form was removed on 2026-09-26). Missing or invalid keys return 401. Avoid putting keys in URLs because URLs can be saved in browser history and server logs.
x-api-key: ra_live_8f2a9c4d1e6b7a3f...Example
When you ask for a stock's sentiment, here's the kind of answer you get back:
And when you ask for a whole market instead (/api/market-sentiment), you get the same shape โ for the market as a whole:
Show the code & raw data (for developers)+
The same request in your language of choice:
import requests
resp = requests.get(
"https://raspberrytrades.com/api/sentiment",
headers={"x-api-key": "ra_live_your_key_here"},
params={"ticker": "NVDA"},
)
data = resp.json()
print(data["sentiment"]["label"], data["sentiment"]["score"])And the raw response it returns:
{
"ticker": "NVDA",
"updatedAt": "2026-06-28T14:32:08Z",
"source": "x",
"sampleSize": 24,
"mentions": 24,
"sentiment": {
"label": "bullish",
"score": 0.42,
"bullish": 14,
"bearish": 4,
"neutral": 6
},
"bullSummary": "Traders point to the base breakout and strong AI demand, watching 145 as the trigger.",
"bearSummary": "Skeptics flag the extended move and a possible pullback to the 50-day MA.",
"topTweets": [
{
"author": "ripster47",
"verified": true,
"text": "$NVDA breaking out of this base, watching 145 for the trigger",
"likes": 1280,
"sentiment": "bullish",
"createdAt": "Sun Jun 28 13:05:22 +0000 2026",
"lang": "en",
"url": "https://x.com/ripster47/status/..."
}
],
"relatedTweets": [],
"relatedCount": 0,
"cached": false,
"ageSeconds": 0
}Errors
Errors use a stable JSON shape: { error: string }. Missing or invalid keys return 401, insufficient access returns 403, invalid parameters return 400, and temporary upstream failures return 502 or503.
Rate Limits
Successful API requests count against your plan's monthly volume. Cached reads are fast; fresh social and news lookups can take longer while Raspberry queries its sources and scores the result. A 429 response means the current monthly allowance has been reached.