Coil Board API
Coil은 에이전트가 x402를 통해 한 번에 하나씩 구매할 수 있는 미국 주식 시장(및 롱-온리 BTC/ETH 트렌드 북)의 점수화되고 순위가 매겨진 판독을 게시합니다. 원시 OHLCV를 구매하는 것이 아닙니다 — 그것은 어디서나 무료입니다. 여러분이 구매하는 것은 판단입니다: 어떤 종목이 매수에 적합한지, 레짐이 얼마나 강력한지, 그리고 오늘의 보드 순위는 무엇인지, 하향식으로 읽습니다.
여기의 모든 것은 비개인적인 연구 출판물입니다 — 모든 구매자에게 동일하며, 점수와 상태만 제공하고, 절대 중지 또는 목표 가격을 제시하지 않으며, 개인화된 조언도 아닙니다. 시장은 손실을 볼 수 있습니다.
이 스킬을 사용하는 경우
- 비용이 많이 드는 작업을 하기 전에 시장-레짐 게이트가 필요한 경우: 지금 위험-온인가요 위험-오프인가요? →
/api/board/regime호출 ($0.005). - 500개 종목을 직접 스캔하지 않고 오늘의 순위별 매수 후보를 원하는 경우 →
/api/board/buylist호출 ($0.02). - 전체 보드 — 네 개의 북, 섹터 레인, 두 개의 매수 리스트 레인에 걸쳐 점수화된 모든 종목 — 를 원하여 직접 선택을 수행하려는 경우 →
/api/board/agent호출 ($0.25).
엔드포인트 (15개 — 전체 카탈로그는 GET https://coil.trade/api에서 확인)
| 엔드포인트 | 가격 (USDC) | 반환 내용 |
|---|---|---|
GET https://coil.trade/api/board/regime | 0.005 | 북별 레짐 판정 (위험-온 / 선별적 / 대기) + 인덱스→섹터→종목 권한 사다리. |
GET https://coil.trade/api/board/crypto | 0.005 | BTC/ETH 롱-온리 트렌드 신호: 슬리브별 LONG 또는 CASH, 50일 게이트 + BTC 200일 마스터 게이트 (UTC 일일 종가 기준). |
GET https://coil.trade/api/board/indices | 0.005 | 북별 점수화된 인덱스 행 (SPY, QQQ, 매크로, BTC/ETH) — 가장 저렴한 하향식 판독. |
GET https://coil.trade/api/board/name?sym=NVDA | 0.005 | 한 주식의 전체 판독 + 해당 북의 레짐. 약 560개 종목 가능. |
GET https://coil.trade/api/board/movers | 0.005 | 상위 10개 상승 종목 + 10개 하락 종목, 전체 점수화. |
GET https://coil.trade/api/board/sectors | 0.01 | 모든 섹터 ETF 점수화 + 레짐의 녹색 섹터. |
GET https://coil.trade/api/board/sector?name=Energy | 0.01 | 한 섹터의 구성원, 전체 점수화 및 순위화 (?etf=XLE도 작동). |
GET https://coil.trade/api/board/leaders | 0.01 | 북별 기회 기준 상위 10개 리더십 종목. |
GET https://coil.trade/api/board/buylist | 0.02 | 오늘의 두 레인에 걸친 북별 순위 후보, 진입 윈도우 및 리더십 플래그 포함. |
GET https://coil.trade/api/board/top-volume | 0.02 | 모든 섹터에서 20일 달러 거래량 기준 상위 5개, 전체 점수화. |
GET https://coil.trade/api/crypto/gate | 0.001 | 가장 저렴한 확인: BTC 200일 마스터 게이트가 열려 있나요? 슬리브별 LONG/CASH + 판정. |
GET https://coil.trade/api/tradfi-risk | 0.003 | 암호화폐 에이전트를 위한 TradFi 위험-온/오프: S&P + 나스닥 레짐, 섹터 폭, 사다리 + BTC/ETH 게이트. |
GET https://coil.trade/api/board/brief | 0.02 | 아침 브리핑: 북별 레짐 + 상위 5개 추천 + 가장 큰 변동 종목 + 암호화폐 게이트, 한 번의 호출로. |
GET https://coil.trade/api/board/asof?date=YYYY-MM-DD | 0.02 | 시점 보관 점수, 추가-전용 로그에서 그대로 — 무료 /api/board/proof에 대해 검증 가능. |
GET https://coil.trade/api/board/agent | 0.25 | 전체 보드: 약 560개 점수화된 종목, 네 개의 북, 섹터 보드, 두 개의 매수 리스트 레인. |
지불 전 무료: GET /api/perf (엔진의 SPY/QQQ 대비 기록) 및
GET /api/board/proof (추가-전용 sha256 커밋과 재현 가능한 검증 레시피) — 신뢰하기 전에 게시자를 확인하세요. 이메일로 POST /api/key하면 즉시 무료 키를 반환합니다 (~25회/일 라이브 호출, 저렴한 슬라이스용, X-Coil-Key 헤더).
지갑이 없나요? 동일한 보드는 원격 MCP 서버로도 사용할 수 있습니다 — 무료 등급, 하루 지연된 전체 보드: claude mcp add --transport http coil https://coil.trade/mcp
브로커와의 연동 (루프 닫기)
Coil은 무엇을 볼지 게시합니다; 주문을 하지 않으며 계정을 보지 않습니다. 에이전트가 실행 기능도 가지고 있는 경우 — Robinhood의 Trading MCP (에이전트 계정, 예산이 있는 하위 계정) 또는 Alpaca의 MCP/CLI (모의 거래, 자금이 있는 계정 불필요) — 두 서버를 동일한 클라이언트에 로드하고 다음 읽기 순서를 따르세요:
get_market_regime— 사다리가 종목을 허용하지 않으면 대기. 주문을 하지 마세요.get_buy_list— 해당 목록에 있는 종목만 고려하세요.get_stock_read/get_sector_read— 투입하기 전에 후보를 심층 분석하세요.- 그런 다음에만 브로커의 도구를, 운영자의 자신의 규칙에 따라 크기를 조정하여 사용하세요.
get_morning_brief는 단계 1–2를 한 번의 호출로 축소합니다. Coil은 포지션 크기, 중지 가격 및 목표 가격을 내보내지 않습니다 — 위험 정의는 운영자에게 속하며 게시자에게 속하지 않습니다. 전체 레시피: https://coil.trade/agents/robinhood
모든 라이브 슬라이스는 동일한 최신 페이로드에서 읽습니다 (as-of 아카이브는 요청된 날짜를 대신 제공), 따라서 저렴한 슬라이스는 전체 보드보다 더 오래되지 않습니다. 미국 시장 시간 동안 보드는 약 5분마다 재계산됩니다; 페이로드는 computed_at 및 intraday 플래그와 함께 freshness 블록을 전달하여 다시 지불할 가치가 있는 시기를 알려줍니다.
먼저 무료로 시도하세요
지불하기 전에 무료 미리보기에 대해 파서를 검증하세요 — 유료 보드와 동일한 스키마, 이전 날짜, 북별 상위 3개 종목:
GET https://coil.trade/api/board/agent?preview=1
항상 무료인 지연 샘플도 GET https://coil.trade/api/board/free에서 제공됩니다.
지불 방식 (x402)
- 지불 없이 엔드포인트에
GET요청을 보냅니다. HTTP 402와 함께 JSON 본문이 반환되며,accepts[0]에 요구사항이 설명됩니다:amount(원자 USDC, 6자리 소수 —5000= $0.005),asset(USDC0x8335…2913),network(eip155:8453, Base), 및payTo. - 해당 금액에 대한 EIP-3009
TransferWithAuthorization에 서명하고PAYMENT-SIGNATURE헤더 (base64 x402 v2 페이로드)와 함께 요청을 다시 보냅니다. - 성공 시 HTTP 200과 함께 JSON 보드와
PAYMENT-RESPONSE헤더의 온체인 영수증을 받게 됩니다.
모든 표준 x402 클라이언트가 이 루프를 처리합니다 — 예: EVM 서명자를 사용한 x402-fetch, Coinbase AgentKit, 또는 x402 MCP 브리지. 엔드포인트는 Coinbase CDP x402 Bazaar에 인덱싱되어 있습니다; 검색 메타데이터는 https://coil.trade/.well-known/x402 및 OpenAPI 사양은 https://coil.trade/openapi.json에서도 확인 가능합니다.
페이로드 읽기
각 점수화된 종목은 (반환된 필드 이름):
opp_pct— 기회, 0–100. 보드의 주요 혼합.entry_q— 진입 품질, 0–100. 지금 매수 가능 vs 연장됨. 타이밍, 조언이 아님.hold_q— 보유 강도, 0–100. 트렌드 지속성.state—firing/ready/setup/wait/chase/falling.sector,is_leader, 및 (매수 리스트 레인에서)READY와 같은window메모.
각 북은 regime 객체를 전달합니다: mode, 일반 언어 verdict, 어떤 섹터가 녹색인지, 그리고 개별 종목이 진입 가능한지 여부를 알려주는 ladder (인덱스 → 섹터 → 종목). 하향식으로 읽으세요: 레짐이 대기라고 말하면, 그 아래의 순위화된 종목은 맥락일 뿐, 녹색 불빛이 아닙니다.
다시 방문할 시기 알기
보드는 이동식 판독이지, 일회성 파일이 아닙니다. regime을 저렴하게 폴링하여 더 풍부한 슬라이스를 구매할지 결정하세요. freshness.next_refresh_at 필드는 새 페이로드에 대해 지불할 가치가 있는 가장 빠른 시기를 알려줍니다; 더 빠르게 폴링하면 동일한 바이트가 반환됩니다. 미국 시장 시간 외에는 아침 스냅샷을 받게 됩니다.
이것이 아닌 것
투자 조언, 관리 계정, 수익을 약속하는 신호 서비스, 또는 이익 보장이 아닙니다. 점수는 과거 및 기술적 데이터에서 파생되며 미래 결과를 예측하지 않습니다. https://coil.trade/terms를 참조하세요.