Skip to content

Docs / All tools / Base tools

stock.analyze

Analyze a stock, ETF, or cryptocurrency and outline short-, medium-, and long-term scenarios. For research purposes.

25 credits. Per analysis.

Example prompt

Send this to your AI app when Heelo is connected:

Analyze NVDA and give me a 1-year outlook

Input fields

FieldTypeDescription
queryRequiredstringNatural-language stock request
modestringOne of: summary, predict, both
termsarray of stringAny of: short, medium, long

Output fields

The fields in data when status is success.

FieldType
tickerstring
asset_typestring
summaryobject
forecastsarray of object
as_ofstring
sourcesarray of string
disclaimerstring
answerstring

Code

The call with the input fields that the tool needs. Set HEELO_API_KEY to your API key.

import os
import requests

response = requests.post(
    "https://toolsprimitives.uk/v1/tools/stock.analyze/invoke",
    headers={"Authorization": f"Bearer {os.environ['HEELO_API_KEY']}"},
    json={"input": {
        "query": "Analyze NVDA and give me a 1-year outlook",
    }},
    timeout=120,
)
response.raise_for_status()
print(response.json())