Catalog / AAII Investor Sentiment

AAII Investor Sentiment API

aaii.com

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.

  • Finance
  • investing
  • sentiment
  • markets
  • AAII
2 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In 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 key

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

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.

View call pricing
cURL · Current sentiment
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?object
commentary.url?string | null
commentary.date?string | null
commentary.title?string | null
commentary.summary?string | null
current_weekobject
current_week.datestring
current_week.bearishnumber
current_week.bullishnumber
current_week.neutralnumber
recent_weeksobject[]
recent_weeks[].datestring
recent_weeks[].bearishnumber
recent_weeks[].bullishnumber
recent_weeks[].neutralnumber
one_year_highsobject
one_year_highs.bearish_highobject
one_year_highs.bearish_high.valuenumber
one_year_highs.bearish_high.week_endingstring
one_year_highs.bullish_highobject
one_year_highs.bullish_high.valuenumber
one_year_highs.bullish_high.week_endingstring
one_year_highs.neutral_highobject
one_year_highs.neutral_high.valuenumber
one_year_highs.neutral_high.week_endingstring
special_questionobject
special_question.answers?object[]
special_question.answers[].votes?integer | null
special_question.answers[].answerstring
special_question.answers[].percentage?number | null
special_question.question?string | null
special_question.total_votes?integer, default: 0
special_question.question_date?string | null
workbook_averagesobject
workbook_averages.bearishnumber
workbook_averages.bullishnumber
workbook_averages.neutralnumber
historical_averages?object
historical_averages.bearishnumber
historical_averages.bullishnumber
historical_averages.neutralnumber
live_vote_percentagesobject
live_vote_percentages.bearish?number | null
live_vote_percentages.bullish?number | null
live_vote_percentages.neutral?number | null

Fields 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_rangeobject
date_range.endstring
date_range.startstring
total_weeksinteger
weekly_dataobject[]
weekly_data[].datestring
weekly_data[].spreadnumber
weekly_data[].bearishnumber
weekly_data[].bullishnumber
weekly_data[].neutralnumber
weekly_data[].bear_avgnumber
weekly_data[].bull_avgnumber

Don’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.