API Coil Board
A Coil publica uma leitura classificada e ranqueada do mercado de ações dos EUA (e um livro de tendências long-only de BTC/ETH) que um agente pode comprar uma leitura por vez via x402. Você não está comprando OHLCV bruto — isso é gratuito em qualquer lugar. Você está comprando o julgamento: quais nomes estão posicionados para compra, quão forte é o regime e como o board se classifica hoje, lido de cima para baixo.
Tudo aqui é uma publicação de pesquisa impessoal — idêntica para cada comprador, apenas pontuações e estados, nunca preços de stop ou alvo, nunca aconselhamento individualizado. Mercados podem gerar perdas.
Quando usar este skill
- Você precisa de uma barreira de regime de mercado antes de fazer algo caro: é risk-on ou risk-off agora? → chame
/api/board/regime($0,005). - Você quer os candidatos de compra ranqueados de hoje sem escanear 500 nomes você mesmo → chame
/api/board/buylist($0,02). - Você quer o board completo — todos os nomes pontuados em quatro livros, faixas setoriais, ambas as faixas de lista de compra — para fazer sua própria seleção → chame
/api/board/agent($0,25).
Os endpoints (15 — catálogo completo em GET https://coil.trade/api)
| Endpoint | Preço (USDC) | Retorna |
|---|---|---|
GET https://coil.trade/api/board/regime | 0,005 | Veredito do regime por livro (risk-on / be-selective / stand-down) + a escada índice→setor→nome. |
GET https://coil.trade/api/board/crypto | 0,005 | Sinal de tendência long-only BTC/ETH: LONG ou CASH por sleeve, gates de 50 dias + gate mestre BTC 200 dias (fechamentos diários UTC). |
GET https://coil.trade/api/board/indices | 0,005 | Linha de índice pontuada por livro (SPY, QQQ, macro, BTC/ETH) — a leitura top-down mais barata. |
GET https://coil.trade/api/board/name?sym=NVDA | 0,005 | Leitura completa de uma ação + o regime do seu livro. Qualquer um dos ~560 nomes. |
GET https://coil.trade/api/board/movers | 0,005 | Top 10 ganhadores + 10 perdedores, totalmente pontuados. |
GET https://coil.trade/api/board/sectors | 0,01 | Cada ETF setorial pontuado + os setores verdes do regime. |
GET https://coil.trade/api/board/sector?name=Energy | 0,01 | Membros de um setor, totalmente pontuados e ranqueados (?etf=XLE também funciona). |
GET https://coil.trade/api/board/leaders | 0,01 | Top 10 nomes de liderança por livro, por oportunidade. |
GET https://coil.trade/api/board/buylist | 0,02 | Candidatos ranqueados de hoje por livro em duas faixas, com janelas de entrada e flags de liderança. |
GET https://coil.trade/api/board/top-volume | 0,02 | Top-5 por volume em dólar de 20 dias em cada setor, totalmente pontuados. |
GET https://coil.trade/api/crypto/gate | 0,001 | A verificação mais barata: o gate mestre BTC de 200 dias está aberto? LONG/CASH por sleeve + veredito. |
GET https://coil.trade/api/tradfi-risk | 0,003 | Risco TradFi on/off para agentes de cripto: regime S&P + Nasdaq, amplitude setorial, escada + gate BTC/ETH. |
GET https://coil.trade/api/board/brief | 0,02 | O briefing matinal: regime por livro + top-5 escolhas + maiores movimentadores + gate cripto, em uma chamada. |
GET https://coil.trade/api/board/asof?date=YYYY-MM-DD | 0,02 | Pontuações arquivadas em um ponto no tempo, verbatim do log append-only — verificável contra o /api/board/proof gratuito. |
GET https://coil.trade/api/board/agent | 0,25 | O board completo: ~560 nomes pontuados, todos os quatro livros, boards setoriais, ambas as faixas de lista de compra. |
Grátis, antes de qualquer pagamento: GET /api/perf (o histórico do motor vs SPY/QQQ) e GET /api/board/proof (compromissos sha256 append-only com uma receita de verificação reproduzível) — verifique o editor antes de confiar. POST /api/key com um email retorna uma chave gratuita instantânea (~25 chamadas ao vivo/dia nos slices baratos, cabeçalho X-Coil-Key).
Sem carteira? O mesmo board também é um servidor MCP remoto — camada gratuita, board completo com atraso de um dia de mercado: claude mcp add --transport http coil https://coil.trade/mcp
Emparelhando com uma corretora (fechando o loop)
A Coil publica o que observar; ela nunca coloca ordens e nunca vê uma conta. Se o agente também tiver execução — Trading MCP da Robinhood (contas agênticas, subconta orçada) ou MCP/CLI da Alpaca (paper trading, nenhuma conta financiada necessária) — carregue ambos os servidores no mesmo cliente e siga esta ordem de leitura:
get_market_regime— se a escada não permitir nomes, pare. Não coloque ordens.get_buy_list— considere apenas nomes que aparecem nela.get_stock_read/get_sector_read— aprofunde-se nos candidatos antes de se comprometer.- Só então as ferramentas da corretora, dimensionadas pelas próprias regras do operador.
get_morning_brief colapsa as etapas 1–2 em uma chamada. A Coil não emite tamanhos de posição, preços de stop ou preços alvo — a definição de risco pertence ao operador, não ao editor. Receita completa: https://coil.trade/agents/robinhood
Todos os slices ao vivo leem do mesmo payload mais fresco (o arquivo as-of atende sua data solicitada), então um slice barato nunca está mais desatualizado que o board completo. Durante o horário de mercado dos EUA, o board é recalculado a cada 5 minutos aproximadamente; o payload carrega computed_at e uma flag intraday, além de um bloco freshness informando quando vale a pena pagar novamente.
Experimente grátis primeiro
Antes de pagar, valide seu parser contra a prévia gratuita — esquema idêntico ao board pago, dia anterior, top-3 nomes por livro:
GET https://coil.trade/api/board/agent?preview=1
Há também uma amostra atrasada sempre gratuita em GET https://coil.trade/api/board/free.
Como o pagamento funciona (x402)
- Faça
GETno endpoint sem pagamento. Ele retorna HTTP 402 com um corpo JSON cujoaccepts[0]descreve o requisito:amount(USDC atômico, 6 decimais —5000= $0,005),asset(USDC0x8335…2913),network(eip155:8453, Base) epayTo. - Assine um
TransferWithAuthorizationEIP-3009 para esse valor atépayToe reenvie a requisição com o cabeçalhoPAYMENT-SIGNATURE(payload base64 x402 v2). - Em caso de sucesso, você recebe HTTP 200 com o board JSON e um recibo on-chain no cabeçalho
PAYMENT-RESPONSE.
Qualquer cliente x402 padrão lida com este loop para você — ex. x402-fetch com um signatário EVM, Coinbase AgentKit ou uma ponte x402 MCP. Os endpoints são indexados no Coinbase CDP x402 Bazaar; metadados de descoberta também estão em https://coil.trade/.well-known/x402 e a especificação OpenAPI em https://coil.trade/openapi.json.
Lendo o payload
Cada nome pontuado carrega (nomes dos campos conforme retornados):
opp_pct— oportunidade, 0–100. A mistura principal do board.entry_q— qualidade de entrada, 0–100. Comprável agora vs estendido. Timing, não aconselhamento.hold_q— força de manutenção, 0–100. Durabilidade da tendência.state—firing/ready/setup/wait/chase/falling.sector,is_leadere (em faixas de lista de compra) uma notawindowcomoREADY.
Cada livro carrega um objeto regime: mode, um verdict em linguagem simples, quais setores estão verdes e uma ladder (índice → setor → nome) indicando se nomes individuais podem ser inseridos. Leia de cima para baixo: se o regime disser stand down, os nomes ranqueados abaixo são contexto, não um sinal verde.
Sabendo quando voltar
O board é uma leitura em movimento, não um arquivo único. Consulte regime de forma barata para decidir se deve comprar os slices mais completos. O campo freshness.next_refresh_at informa o momento mais cedo em que vale a pena pagar por um novo payload; consultar mais rápido retorna os mesmos bytes. Fora do horário de mercado dos EUA, você recebe o snapshot matinal.
O que isto não é
Não é aconselhamento de investimento, não é uma conta gerenciada, não é um serviço de sinal que promete retornos e não é uma garantia de lucro. As pontuações são derivadas de dados históricos e técnicos e não preveem resultados futuros. Consulte https://coil.trade/terms.