a1trading.com APIwww.a1trading.com ↗
Access live retail trader sentiment for forex, metals, indices, commodities, and crypto. Get long/short percentages and contrarian signals via one endpoint.
curl -X GET 'https://api.parse.bot/scraper/ac26b74a-3391-41f1-b45d-86d3f60eaf0f/get_retail_sentiment' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieves live retail sentiment data showing what percentage of retail traders are long vs short on each instrument, along with the contrarian signal (Bearish when majority is long, Bullish when majority is short, Neutral when balanced). Data is sorted by long percentage descending.
| Param | Type | Description |
|---|---|---|
| category | string | Filter by instrument category. Accepts exactly one of: Major Currency Pairs, Minor Currency Pairs, Metals, Indices, Commodities, Crypto, Currencies. Omitted returns all categories. |
{
"type": "object",
"fields": {
"pairs": "array of sentiment objects with pair, long_percentage, short_percentage, signal",
"total_count": "integer"
},
"sample": {
"pairs": [
{
"pair": "COPPER",
"signal": "Bearish",
"long_percentage": 91.16,
"short_percentage": 8.84
},
{
"pair": "EURUSD",
"signal": "Neutral",
"long_percentage": 57,
"short_percentage": 43
},
{
"pair": "GOLD",
"signal": "Bullish",
"long_percentage": 28.92,
"short_percentage": 71.08
}
],
"total_count": 52
}
}About the a1trading.com API
The A1 Trading API exposes one endpoint — get_retail_sentiment — that returns live retail positioning data across five instrument categories, with four fields per instrument: pair name, long percentage, short percentage, and a contrarian signal. It covers major and minor currency pairs, metals, indices, commodities, and crypto, making it straightforward to track crowded trades and sentiment extremes in a single call.
What the API returns
The get_retail_sentiment endpoint returns an array of sentiment objects (pairs) plus a total_count integer. Each object in pairs carries the instrument name (pair), the percentage of retail traders positioned long (long_percentage), the percentage positioned short (short_percentage), and a signal field that reflects the contrarian read: Bearish when the majority is long, Bullish when the majority is short, and Neutral when positioning is balanced. Results are sorted by long_percentage descending.
Filtering by category
The optional category parameter filters results to a single instrument group. Accepted values are Major Currency Pairs, Minor Currency Pairs, Metals, Indices, Commodities, and Crypto. Omitting the parameter returns all categories in one response. This lets you scope a call to, say, only metals or only crypto without post-processing the full payload.
Practical notes on the signal field
The signal field encodes a simple contrarian interpretation: when retail traders are heavily skewed long on an instrument, the signal reads Bearish, reflecting the idea that crowded retail longs historically precede reversals. The inverse applies for heavy short positioning. A Neutral signal indicates no strong directional lean. The raw long_percentage and short_percentage values are always present if you want to apply your own threshold logic rather than relying on the pre-computed signal.
- Alert when
long_percentageexceeds a custom threshold on major forex pairs to flag potential reversal setups - Filter by
category: Cryptoto monitor retail crowding in Bitcoin, Ethereum, and other digital assets - Display live long/short bars in a trading dashboard using
long_percentageandshort_percentagefor eachpair - Track changes in
signalover time to detect when sentiment shifts from Neutral to Bearish or Bullish - Build a sentiment heatmap across all categories by pulling the full unfiltered response and grouping by instrument type
- Screen for high-conviction contrarian trades by sorting on
long_percentageand isolating instruments with extreme readings
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does A1 Trading have an official developer API?+
What does the `signal` field actually represent, and can I ignore it and use the raw percentages instead?+
signal field (Bearish, Bullish, or Neutral) is a pre-computed contrarian interpretation based on the balance of long_percentage and short_percentage. It is there for convenience, but the raw percentage fields are always returned, so you can apply your own thresholds or weighting logic without using signal at all.Is historical sentiment data available through this API?+
Does the API return individual trader counts or just aggregate percentages?+
long_percentage and short_percentage only — not the underlying trader count or notional volume behind those figures. The total_count field reflects the number of instruments returned in the response, not the number of traders. You can fork the API on Parse and revise it if additional granularity becomes available from the source.Can I filter by multiple categories in a single request?+
category parameter accepts exactly one value per request. If you need data across several categories simultaneously, you would make one request per category or omit the parameter to receive all instruments in a single response. You can fork the API on Parse and revise it to support multi-category filtering in one call.