# Coil Trade Buy List

> Coil Trade Buy List is a paid API for AI agents from coil.trade, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-13).

Returns today's ranked buy list of top stock candidates across S&P 500, Nasdaq-100, and macro books, with scores and regime context for trading agents.

## Facts

- Endpoint: GET https://coil.trade/api/board/buylist
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coil-trade-buy-list-48b07f2a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_R0FIzqdgRn8VKyIWgVecL

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability coil-trade-buy-list-48b07f2a
```

Example prompt: Pull up today's Coil buy list and tell me the top-ranked stocks across both the risk-adjusted and swing lanes — include their buy, entry, growth, and hold scores, any leadership flags, and whether the regime mode says the list is actually actionable right now.

## When to prefer this

Use this endpoint when an AI trading agent needs a ready-made, scored, ranked list of actionable stock candidates rather than building its own screening logic. Prefer it over raw market data feeds when you want pre-computed buy/entry/growth/hold scores and regime context in a single call. Ideal for agents that need to act quickly during market hours without maintaining their own ranking infrastructure.

## Known failure modes

- Market closed or pre-market — regime mode may indicate list is not actionable
- Stale data if called outside refresh window (~5 min cadence)
- Empty or minimal list if no candidates meet scoring thresholds
- 402 Payment Required if x402 payment header is missing or underfunded
- Rate limiting or quota errors if called too frequently

## How this service works

Which stocks to buy now — trading signals as a ranked buy list for agents. Returns today's top candidate names per book (S&P 500, Nasdaq-100, macro) across two lanes, risk-adjusted and swing, each with buy / entry / growth / hold scores, a leadership flag and an entry-window note — plus the regime mode telling you whether the list is actionable at all. Ranked judgment, not raw data. Refreshed ~5 min in market hours. Research, not advice.

## Output

A ranked list of top stock candidates per book (S&P 500, Nasdaq-100, macro) across two lanes (risk-adjusted and swing), each entry including buy/entry/growth/hold scores, a leadership flag, an entry-window note, and a regime mode field indicating whether conditions make the list actionable at all. Refreshed approximately every 5 minutes during market hours.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "books": {
   "spx": {
    "label": "SPX",
    "picks": {
     "swing": [],
     "riskadj": [
      {
       "buy": 71,
       "sym": "CVX",
       "hold": 82,
       "lead": true,
       "name": "Chevron",
       "entry": 64,
       "sector": "Energy",
       "window": "READY"
      }
     ]
    },
    "regime_mode": "NAMES_ON"
   }
  },
  "product": "coil-buylist",
  "freshness": {
   "poll_hint": "Market open — this board recomputes about every 5 minutes; polling faster returns the same payload.",
   "market_open": true,
   "next_refresh_at": "<ISO-8601 UTC — always present; do not re-buy before this>",
   "data_age_seconds": 142
  },
  "asof_daily": "2026-07-17",
  "book_order": [
   "spx",
   "qqq",
   "macro"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/coil-trade-buy-list-48b07f2a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from coil.trade](https://www.zero.xyz/host/coil.trade/llms.txt)