AAII Investor Sentiment API
Live read-only access to AAII's public investor-sentiment workbook. National weekly readings, recent values, one-year highs and workbook-derived averages are available. The current public page does not expose special-question, live-vote, commentary-card or state-level sentiment percentages anonymously; those fields are returned as null or empty rather than inferred.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.
Then ask your agent to use the AAII Investor Sentiment API for your task.
Call it over HTTP
Get an API keySign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/d1313ed5-50fe-4304-a803-6d081946b481/v1/sentiment/current' \
--header "Authorization: Bearer $AGENT_DATA_API_KEY"Endpoints
Inputs and response fields for every endpoint in this API.
GETCurrent sentiment/v1/sentiment/current
Returns the latest national AAII reading, the four strictly preceding weeks, one-year highs and averages computed from the live public workbook. AAII's current public page gates voting and does not publish state or special-question percentages; those documented fields remain empty.
Input
No input parameters.
Response
commentary?objectcommentary.url?string | nullcommentary.date?string | nullcommentary.title?string | nullcommentary.summary?string | nullcurrent_weekobjectcurrent_week.datestringcurrent_week.bearishnumbercurrent_week.bullishnumbercurrent_week.neutralnumberrecent_weeksobject[]recent_weeks[].datestringrecent_weeks[].bearishnumberrecent_weeks[].bullishnumberrecent_weeks[].neutralnumberone_year_highsobjectone_year_highs.bearish_highobjectone_year_highs.bearish_high.valuenumberone_year_highs.bearish_high.week_endingstringone_year_highs.bullish_highobjectone_year_highs.bullish_high.valuenumberone_year_highs.bullish_high.week_endingstringone_year_highs.neutral_highobjectone_year_highs.neutral_high.valuenumberone_year_highs.neutral_high.week_endingstringspecial_questionobjectspecial_question.answers?object[]special_question.answers[].votes?integer | nullspecial_question.answers[].answerstringspecial_question.answers[].percentage?number | nullspecial_question.question?string | nullspecial_question.total_votes?integer, default: 0special_question.question_date?string | nullworkbook_averagesobjectworkbook_averages.bearishnumberworkbook_averages.bullishnumberworkbook_averages.neutralnumberhistorical_averages?objecthistorical_averages.bearishnumberhistorical_averages.bullishnumberhistorical_averages.neutralnumberlive_vote_percentagesobjectlive_vote_percentages.bearish?number | nulllive_vote_percentages.bullish?number | nulllive_vote_percentages.neutral?number | nullFields marked ? are optional.
GETHistorical sentiment/v1/sentiment/historical
Returns the latest 52 Wednesday week-ending readings from AAII's live structured Excel download. bull_avg and bear_avg are cumulative averages over the returned one-year window, and spread is bullish minus bearish.
Input
No input parameters.
Response
date_rangeobjectdate_range.endstringdate_range.startstringtotal_weeksintegerweekly_dataobject[]weekly_data[].datestringweekly_data[].spreadnumberweekly_data[].bearishnumberweekly_data[].bullishnumberweekly_data[].neutralnumberweekly_data[].bear_avgnumberweekly_data[].bull_avgnumberDon’t see the endpoint you need?
Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.
An account is required to submit an extension. Prepare your request, then sign in to build.