Catalog / A1 Trading Retail Sentiment

A1 Trading Retail Sentiment API

a1trading.com

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.

  • finance
  • sentiment
  • markets
  • retail-positioning
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 A1 Trading Retail 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 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).

Optional parameters 3

Optional exact source category label; discover valid labels first.

Zero-based source row offset for continuation.

Number of source rows requested from the report; the source may return fewer rows than requested.

View call pricing
cURL · Retail sentiment
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 | null

Optional exact source category label; discover valid labels first.

Example: Major Currency Pairs

offsetOptionalQuery · integer, min: 0, default: 0

Zero-based source row offset for continuation.

Example: 0

limitOptionalQuery · integer, min: 1, default: 100

Number of source rows requested from the report; the source may return fewer rows than requested.

Example: 10

Response

limitinteger, min: 1
pairsobject[]
pairs[].pairstring
pairs[].signalstring
pairs[].long_percentagenumber, min: 0, max: 100
pairs[].short_percentagenumber, min: 0, max: 100
offsetinteger, min: 0
next_offset?integer, min: 0 | null
total_countinteger, min: 0
returned_countinteger, min: 0

Fields 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[].labelstring
total_countinteger, min: 0

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.