Skip to content
Browse documentation
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.

Base URL
https://raspberrytrades.com

Examples, 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.

ProductEndpointDocs
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.

1

Create your account & copy your key

Sign up (free to start), open your dashboard and copy your ra_live_โ€ฆ key.

2

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"])
3

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.

1

Install Tampermonkey

A free browser extension that runs small add-ons. Get it for your browser at tampermonkey.net.

2

Add the Raspberry add-on(s)

Click an add-on below โ€” Tampermonkey opens an install screen, then press Install. The first time it runs it asks for your API key (from your dashboard); it's saved in your browser and the add-on auto-updates. Install whichever tools you use, or install all four.

3

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.

Request header
x-api-key: ra_live_8f2a9c4d1e6b7a3f...

Example

When you ask for a stock's sentiment, here's the kind of answer you get back:

NVDA
NVIDIA Corp.
Bullish
Score
+0.42
Tweets analyzed
24
TSLA
Tesla, Inc.
Bearish
Score
โˆ’0.18
Tweets analyzed
31

And when you ask for a whole market instead (/api/market-sentiment), you get the same shape โ€” for the market as a whole:

โ‚ฟ
Bitcoin
Bearish
Score
โˆ’0.16
Tweets analyzed
81
๐Ÿฅ‡
Gold
Bullish
Score
+0.21
Tweets analyzed
58
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:

200 OK ยท application/json
{
  "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.