A1 Trading Retail Sentiment API
Live, read-only retail positioning from A1 Trading's public EdgeFinder report. Start with the category discovery operation, then pass a returned label unchanged to the paginated sentiment operation. No login or website mutation is performed.
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 A1 Trading Retail 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/aed626e4-491f-4f8a-a4e9-cc29ba662dbb/v1/retail-sentiment' \
--header "Authorization: Bearer $AGENT_DATA_API_KEY"Endpoints
Inputs and response fields for every endpoint in this API.
GETRetail sentiment/v1/retail-sentiment
Returns one live source page of instrument positioning. Omit category for all source rows, or pass a label from the category discovery operation. Offset is zero-based and next_offset is reusable with the same category. Percentages are source fractions normalized to 0-100; signal is derived strictly from which side is the majority (long majority is bearish, short majority bullish).
Input
categoryOptionalQuery · string | nullOptional exact source category label; discover valid labels first.
Example: Major Currency Pairs
offsetOptionalQuery · integer, min: 0, default: 0Zero-based source row offset for continuation.
Example: 0
limitOptionalQuery · integer, min: 1, default: 100Number of source rows requested from the report; the source may return fewer rows than requested.
Example: 10
Response
limitinteger, min: 1pairsobject[]pairs[].pairstringpairs[].signalstringpairs[].long_percentagenumber, min: 0, max: 100pairs[].short_percentagenumber, min: 0, max: 100offsetinteger, min: 0next_offset?integer, min: 0 | nulltotal_countinteger, min: 0returned_countinteger, min: 0Fields marked ? are optional.
GETRetail sentiment categories/v1/retail-sentiment/categories
Returns the current category labels exposed by A1 Trading's report dimension selector. Use a returned label unchanged as the category parameter of the sentiment operation; the list is live and may change.
Input
No input parameters.
Response
categoriesobject[]categories[].labelstringtotal_countinteger, min: 0Don’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.