API Documentation

Use the SheetChat API to access a discovery chartbot tailored to the eToro universe. Users can ask questions about which stocks they can buy, recent news, dividends, earnings, fundamentals, sector breakdowns, Popular Investors, and much more.

Before you can make requests to the SheetChat API, you will need to grab your API key from the Bullsheet team. Please contact Filipe or Joao.

Start Chat Explore examples

POST/api/discovery

Endpoints

This endpoint allows you to send and receive messages from SheetChat. To include your investor context, you must provide your username.

Required attributes

Name
prompt
Type
string
Description
The question for the chatbot.
Name
history
Type
Array<{ role: 'user' | 'assistant', content: string }>
Description
The history of the conversation.
Name
streaming
Type
boolean
Description
Whether to stream the response.

Optional attributes

Name
generateChatTitle
Type
boolean
Description
Whether to generate a title for the answer/chart.
Name
generateFollowUpQuestions
Type
boolean
Description
Whether to generate follow up questions.
Name
portfolio
Type
Array<{ instrumentId: int, ticker: string, valuePct: float }>
Description
The portfolioof the user, for questions about their portfolio.
Name
watchlist
Type
string[]
Description
The watchlist instrument IDs of the user, for questions about their watchlists.

Request

POST

/api/discovery

curl -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -X POST https://chat.bullsheet.me/api/discovery \
     -d '{"prompt":"Any important news in tech lately?", "history": [], "streaming": false, "username": "FilipeSommer"}'

Response

{
  "answer": "Here are some recent news items about Meta Platforms Inc (META):\n\n*   **AI Focus:** Meta is shifting its focus to AI development, leading to workforce restructuring and potential acquisition of AI chip group FuriosaAI.\n*   **Stock Performance:** META's stock experienced a record winning streak, though there's discussion about whether it can reach $1,000 in 2025.\n*   **Workplace Issues:** Meta is facing a lawsuit over alleged toxic patterns of silencing women.\n*   **Data Privacy:** There are reports of gambling firms sharing user data with Facebook without permission.\n\n**Sources:** GuruFocus, TipRanks, CNBC, Investopedia, Fortune, The Guardian",
  "chartData": [],
  "chartType": "None",
  "threeFollowUpQuestions": [
    "What are the specific details of Meta's AI initiatives?",
    "How is the market reacting Google's restructuring and layoffs?",
    "What is the status of the lawsuit against Apple?"
  ],
  "type": "text"
}

Charts

These are the charts that are currently supported: