{"uid":"cap_LqOAxMHTk2Gu-qcnSwnx0","slug":"coil-sector-drill-down-fb27ee4e","name":"Coil Sector Drill-Down","description":"Every stock in one sector, scored — GET /api/board/sector?name=Energy (or ?etf=XLE) returns each member of that sector with the full Coil read: opportunity 0-100 + percentile, entry quality and state, hold strength, growth score, overnight gap-risk score, leadership flag and dollar volume, ranked by opportunity, plus the sector's own ETF row. All 20 sector groups across the S&P 500, Nasdaq-100 and macro book. ~5-min refresh. Research, not advice.","url":"https://coil.trade/api/board/sector","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"etf":{"sym":"XLE","light":"g","state":"cold","opp_pct":80,"opp_score":62.1},"sector":"Energy","members":[{"sym":"XOM","name":"Exxon Mobil","state":"ready","hold_q":84,"entry_q":70,"opp_pct":91,"gap_risk":14,"adv20_usd":2100000000,"gap_level":"LOW","is_leader":true,"growth_score":55}],"product":"coil-sector","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-22"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__2ns9bV5VTCsjXRk6XUIj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns every stock in a given sector with full Coil scores (opportunity, entry quality, hold strength, growth, gap-risk, leadership) ranked by opportunity, plus the sector ETF row","exampleAgentPrompt":"Pull the full Coil sector drill-down for Energy — give me every stock scored by opportunity, entry quality, hold strength, and gap-risk, ranked best to worst, using either the sector name 'Energy' or the ETF ticker XLE.","exampleUseCases":null,"resultDescription":"A ranked list of every stock in the specified sector, each with: opportunity score (0-100) and percentile, entry quality and state, hold strength score, growth score, overnight gap-risk score, leadership flag, dollar volume — plus the sector's own ETF row at the top. Unknown sector names return the sector directory instead.","failureModes":["Unknown sector name returns sector directory listing rather than stock scores","Invalid ETF ticker returns an error or empty result","Missing both 'name' and 'etf' query parameters may return an error or the sector directory","Rate limiting or payment failure (x402) if USDC payment not properly handled","Network timeout for large sectors with many constituents"],"whenToPreferThis":"Use this endpoint when you need a comprehensive, scored view of all stocks within a specific sector — especially when doing sector rotation analysis, comparing opportunity scores within a sector, or identifying the best entry candidates inside Energy, Technology, Financials, or any of the 20 supported sector groups. Prefer this over the single-name endpoint when you don't know which specific stock to examine and want to survey the entire sector landscape.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:41:15.475Z","isFirstParty":false}