Loading page…
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 AAPL insider and NVDA guidance pages are also public demos.
Start with the question, not the endpoint name. Each link opens a focused guide with the request, response fields, source and limitations.
Social sentiment, multi-source news and how market mood changes over time.
The two products that scan the market for you: breakout setups from the chart and the trusted network, and strategy matches across the universe.
Rules-based trading systems: the library, their live signals and the historical backtest.
Your keys, your quota and the private influencer lists that feed your own responses.
Official SEC filings, insider trades, reported financials and company guidance.
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 |
| 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 |
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.
From zero to live market sentiment in about a minute.
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"])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.
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.
A free browser extension that runs small add-ons. Get it for your browser at tampermonkey.net.
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.
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.
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.
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.
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.
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...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:
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 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.
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.