Runtime nativo de IA para estratégias Alpaca
Desenvolva no Cursor, Claude Code ou em qualquer IDE de IA. Faça o deploy a partir do GitHub em um runtime de nuvem gerenciado com controle MCP nativo, logs e seleção de região.
Seção 01 · Resumo
Resumo
- Corretora
- Alpaca Securities LLC
- Tipo de corretora
- Corretora de varejo regulada nos EUA, focada em API
- Classe de ativos
- Ações dos EUA, opções dos EUA, cripto
- Cobertura de ativos
- Ações dos EUA (listadas na NYSE, NASDAQ, NYSE ARCA, BATS, IEX), opções listadas nos EUA (single-leg e multi-leg, compensadas pela OCC), cripto (via subsidiária Alpaca Crypto LLC), frações de ações, ETFs.
- Modelo de runtime
- Runtime de estratégia em container
- Origem do deploy
- GitHub
- Linguagens
- Qualquer linguagem compatível com containers
- Integrações comuns
- alpaca-py (SDK Python atual), alpaca-trade-api (legada), alpaca-trade-api-js, clientes nativos REST e WebSocket, NautilusTrader, conectores personalizados
- Integração com fluxo de IA
- Superfície de controle MCP para Cursor, Claude Code, GitHub Copilot e agentes de CLI
- Papel da TradingHost
- Runtime, deploy, logs, monitoramento de integridade, seleção de região, controle MCP
- Papel da Alpaca
- Conta de corretora, acesso à API, dados de mercado, ambiente de execução, custódia, liquidação, relatórios fiscais
- Reguladores
- Alpaca Securities LLC: broker-dealer registrado na SEC e FINRA (CRD 288257). Membro do SIPC. Alpaca Crypto LLC: Money Services Business registrada na FinCEN para negociação de cripto.
- Varejo dos EUA
- Sim. Suporte para paper trading e live trading.
- Afiliação
- A TradingHost é independente e não possui afiliação com a Alpaca Securities LLC ou Alpaca Crypto LLC
Seção 02 · O que Alpaca oferece
O que Alpaca oferece
A Alpaca disponibiliza uma API REST e WebSocket focada em desenvolvedores, cobrindo ações dos EUA, opções dos EUA e cripto sob uma única credencial. A Trading API e a Market Data API operam em hosts separados. Os ambientes de paper trading e live trading compartilham a mesma estrutura de endpoints e chaves distintas, permitindo que uma estratégia testada em simulação passe para produção sem necessidade de reescrever o código. Caminhos de endpoints específicos, limites de taxa (rate limits) e planos de assinatura de dados estão detalhados na documentação da Alpaca.
Mercados e padrões de estratégia
- Rebalanceamento de portfólio compatível com frações de ações
- Estratégias de opções dos EUA single-leg e multi-leg
- Ações, opções e cripto sob uma única Trading API unificada
- Estratégias validadas em simulação que passam para produção sem alteração de código
- Streaming via WebSocket para cotações, negociações e eventos de conta
- Estratégias de cripto spot da Alpaca Crypto LLC (BTC, ETH e mais)
- Estratégias sistemáticas de ações com dados SIP do Algo Trader Plus
Superfície da API
- Superfícies de produtos
- Trading API v2 para ações dos EUA, opções dos EUA e cripto sob uma única credencial. A Market Data API fornece cotações, negociações e barras em um host separado. Os ambientes de paper trading e live trading utilizam URLs base e chaves distintas; a mesma estrutura de endpoints atende a ambos, permitindo que o código testado em simulação passe para produção sem reescrita.
- Métodos de conexão
- REST para ordens, posições, estado da conta, cadeias de opções e metadados de ativos. Streams de WebSocket para dados de mercado em tempo real (cotações, negociações, barras) e atualizações de negociação no nível da conta. Cripto, ações e opções compartilham as mesmas convenções REST e WebSocket, diferindo apenas por asset_class e caminho do endpoint.
- Autenticação
- ID de chave de API e segredo nos cabeçalhos de requisição APCA-API-KEY-ID and APCA-API-SECRET-KEY. As chaves de paper trading e live trading são emitidas separadamente; uma chave de simulação não pode enviar uma ordem real. O OAuth 2.0 está disponível para aplicações delegadas (como fintechs de front-end de corretoras), e não para acesso individual de estratégias.
Para detalhes específicos, consulte a Alpaca
Endpoints específicos, limites de taxa, planos de assinatura de dados de mercado e requisitos de aprovação de opções estão na documentação da Alpaca. Considere-os como a fonte oficial de informações.
Seção 03 · Desenvolva com IA
Desenvolva sua estratégia para a Alpaca com IA
Escolha um método de integração, faça um fork de um template inicial da TradingHost e desenvolva sua estratégia em uma IDE de IA. Cursor, Claude Code, GitHub Copilot e agentes de IA baseados em CLI funcionam com o mesmo fluxo de deploy nativo do GitHub.
REST e WebSocket nativos da Alpaca
Controle direto sobre o estado da conta Alpaca, endpoints de ordens e a Market Data API. Use qualquer cliente HTTP e WebSocket compatível com seu container.
alpaca-py
O SDK oficial atual para Python da alpacahq. Cobre a Trading API, Market Data API, API de corretora e cripto. Recomendado para novos projetos.
alpaca-trade-api (legada)
SDK Python antigo, ainda mantido para estratégias existentes. A Alpaca recomenda migrar para o alpaca-py para novos desenvolvimentos.
Conector personalizado ou de framework
NautilusTrader, motores proprietários, JavaScript e TypeScript via alpaca-trade-api-js, e qualquer outro framework que encapsule os endpoints REST e WebSocket da Alpaca.
Suporte de bibliotecas e frameworks para produtos da Alpaca
O alpaca-py cobre toda a superfície da Alpaca (ações, opções, cripto, paper trading) e é o SDK recomendado para novos projetos. O alpaca-trade-api continua sendo mantido para estratégias existentes. O NautilusTrader possui uma integração com a Alpaca mantida pela comunidade; confirme a cobertura de opções na documentação atual do adaptador antes de utilizá-lo.
✓ suporte confirmado de acordo com a documentação oficial do SDK ou do adaptador. "parcial" indica cobertura parcial no nível do adaptador; verifique na documentação atual da integração. "verificar SDK" indica que o recurso depende da versão do SDK. Os links de fluxo de trabalho direcionam para páginas em /workflows/ atualmente em desenvolvimento.
O TradingHost não impõe o uso de nenhuma biblioteca. Ele executa o seu projeto.
Desenvolva com IA
Tanto o alpaca-py quanto o alpaca-trade-api funcionam com IDEs de IA. A superfície de controle MCP da TradingHost fecha o ciclo: as ferramentas de IA podem inspecionar deploys, analisar logs e gerenciar o runtime junto com você, sem nunca interferir no caminho de execução das ordens.
Seção 04 · Execute no TradingHost
Execute seu código no TradingHost
A Alpaca fornece a conta da corretora, o acesso à API e o ambiente de execução. O TradingHost fornece o ambiente de produção onde sua estratégia conectada à Alpaca é executada.
Em vez de rodar o código da estratégia em um notebook, computador desktop, VPS genérico ou servidor configurado manualmente, você faz o deploy a partir do GitHub em um runtime de container gerenciado pelo TradingHost.
Você
- Seu repositório contém seu código.
- Seu deploy define como ele é executado.
- Sua estratégia se conecta à Alpaca.
TradingHost
- Mantém o runtime online.
- Exibe logs e health checks.
- Seleção de região.
- Superfície de deploy controlada.
Fluxo de deploy
- PASSO 01
Conecte o GitHub
Autorize o TradingHost a acessar sua conta do GitHub.
- PASSO 02
Vincule um repositório ou use um template inicial
Aponte a TradingHost para o repositório existente da sua estratégia Alpaca ou faça um fork de um template inicial do alpaca-py para ter uma base funcional.
- PASSO 03
Faça o deploy em um container do TradingHost
Escolha uma região (US-East fica mais próximo dos matching engines de ações dos EUA; EU funciona para cripto na sessão europeia), informe sua chave de API e secret da Alpaca como variáveis de ambiente e faça o deploy. O TradingHost compila seu container a partir do repositório e executa sua estratégia em uma infraestrutura gerenciada de Kubernetes. Sem necessidade de instalação local do Docker.
- PASSO 04
Monitore logs e integridade
Acompanhe logs em tempo real, integridade e o estado do runtime diretamente pelo painel do TradingHost. Essa mesma interface pode ser acessada via MCP a partir de qualquer AI IDE, permitindo que o Cursor, Claude Code ou um agente de CLI leiam o estado do deploy e gerenciem o runtime junto com você. A execução dos trades permanece no caminho do código da estratégia, não no MCP.
- PASSO 05
Atualize e faça um novo deploy
Envie as alterações para a branch principal do seu GitHub e a TradingHost realiza o redeploy automaticamente. Um deploy com chaves de simulação é o ambiente de testes ideal antes de migrar para chaves de produção.
Seção 05 · Notas operacionais
Notas operacionais para a Alpaca
Detalhes que podem causar problemas ao executar uma estratégia da Alpaca em um ambiente de nuvem em contêineres, e que nem sempre estão na documentação da Alpaca ou nos READMEs de frameworks. Cada afirmação abaixo foi citada ou parafraseada da própria documentação da Alpaca ou de uma fonte regulatória primária; as orientações de implantação vêm da experiência de rodar essas estratégias na TradingHost.
01 · Cabeçalhos de autenticação
APCA-API-KEY-ID e APCA-API-SECRET-KEY nos cabeçalhos de requisição
A Alpaca autentica as requisições da Trading API com o ID da chave de API e o segredo nos cabeçalhos APCA-API-KEY-ID e APCA-API-SECRET-KEY. Não há uma etapa de assinatura separada. O OAuth 2.0 é um fluxo distinto usado por aplicações delegadas (como uma fintech desenvolvendo soluções na Alpaca para seus clientes), não por estratégias individuais. As chaves de simulação (paper) e de produção (live) são emitidas separadamente e não são intercambiáveis.
02 · Paper vs live
O ambiente paper usa uma URL base diferente e uma chave diferente
O paper trading roda em paper-api.alpaca.markets. O live trading roda em api.alpaca.markets. Os endpoints de streaming via WebSocket diferem de forma semelhante. Chaves geradas para o ambiente paper não podem enviar ordens para o ambiente live e vice-versa. Fora isso, a estrutura de endpoints é idêntica, de modo que o código validado em paper é promovido para live apenas trocando a URL base e o conjunto de chaves. Mantenha os segredos de paper e live em entradas separadas no TradingHost Secrets; nunca reutilize o mesmo segredo entre ambientes.
03 · Níveis de dados de mercado
Básico (apenas IEX) versus Algo Trader Plus (SIP completo dos EUA)
O plano de dados de mercado padrão da Alpaca retorna cotações e negociações apenas da IEX, o que é suficiente para muitas estratégias sistemáticas, mas é um book parcial por definição. O Algo Trader Plus é o plano pago de nível SIP e desbloqueia dados consolidados (consolidated tape). Estratégias que dependem de precisão no topo do book (top-of-book) em todas as bolsas devem declarar uma assinatura do Algo Trader Plus como pré-requisito de implantação; estratégias que funcionam com amostragem apenas da IEX não precisam.
04 · Ações fracionárias
Use notional, e não qty, para ordens fracionárias, e verifique fractionable: true
A Alpaca suporta ações fracionárias para ativos específicos. Para comprar um valor em dólares em vez de uma quantidade de ações, envie uma ordem com notional em vez de qty. Antes de enviar, verifique o endpoint de metadados do ativo e confirme se fractionable: true; nem todo ativo listado é fracionável. Ordens fracionárias canceladas não podem ser parcialmente executadas da mesma forma que ordens de ações inteiras, portanto, o tratamento de erros precisa considerar essa diferença.
FonteAlpaca docs, Orders05 · Aprovação de opções
Exigida separadamente de ações; o nível de aprovação controla as estratégias aceitas
A negociação de opções na Alpaca exige uma etapa de aprovação separada, além do cadastro para ações. O nível de aprovação é exposto no endpoint da conta; ordens que excedem o nível aprovado são rejeitadas pela Alpaca, não pela TradingHost. Planeje a implantação em torno de uma estratégia que se ajuste ao seu nível aprovado ou atualize sua aprovação com a Alpaca antes de implantar. A TradingHost não pode dispensar ou atualizar a aprovação de opções.
06 · Pattern Day Trader
A regra de PDT se aplica a contas de margem abaixo de $25.000, conforme a FINRA Rule 4210
A FINRA Rule 4210 classifica uma conta de margem como Pattern Day Trader após quatro ou mais day trades em um período de cinco dias úteis, e restringe novas operações de day trade até que o patrimônio líquido atinja $25.000. A Alpaca expõe essa sinalização no endpoint da conta (pattern_day_trader). A regra é aplicada na corretora, não no ambiente de execução. Estratégias que realizam day trade com frequência em contas de margem abaixo do limite precisam se planejar para contornar essa restrição ou aportar fundos para manter o saldo da conta acima de $25.000.
07 · Entidade de cripto
Negociações de cripto passam pela Alpaca Crypto LLC, uma entidade separada registrada na FinCEN
A negociação de cripto spot é oferecida pela Alpaca Crypto LLC, uma empresa de serviços monetários registrada na FinCEN, e não pela Alpaca Securities LLC. Do ponto de vista da estratégia, a credencial é a mesma e a interface de ordens é exposta pela mesma Trading API; sob a perspectiva regulatória, a entidade legal é distinta. A cobertura do SIPC se aplica à conta da corretora (broker-dealer), não aos ativos de cripto. Declare isso claramente em qualquer termo de divulgação de risco que você gerar junto com a estratégia.
Seção 06 · Desenvolvido para
Desenvolvido para
Os runtimes do TradingHost para Alpaca são ideais para:
- Desenvolvedores criando estratégias em IDEs de IA (Cursor, Claude Code)
- Traders sistemáticos de ações e opções
- Desenvolvedores quant migrando de notebooks para produção
- Desenvolvedores Python usando alpaca-py
- Traders de varejo migrando de interfaces gráficas de corretoras (Robinhood, Webull, Power E*Trade)
Conectar o GitHub e criar sua primeira estratégia é grátis.
Seção 08 · FAQ
Perguntas frequentes
Não. A TradingHost é independente e não é afiliada à Alpaca Securities LLC ou à Alpaca Crypto LLC.
Não. A TradingHost é um ambiente de execução (runtime) para códigos de estratégias de trading. A Alpaca Securities LLC é a corretora (broker-dealer), registrada na SEC e na FINRA (CRD 288257) e membro do SIPC. Sua conta, custódia, acesso ao mercado, liquidação e relatórios fiscais ficam todos na Alpaca.
Não. O código da sua estratégia se conecta à Alpaca e envia instruções de ordens de acordo com sua própria lógica, permissões de conta e método de integração. A TradingHost fornece o ambiente de execução onde esse código roda.
Não. O acesso à API da Alpaca é fornecido pela própria Alpaca. Você é responsável por sua conta na Alpaca, permissões de API, credenciais e conformidade com os termos da Alpaca.
A AWS e a DigitalOcean oferecem computação bruta. Você mesmo precisa lidar com atualizações de sistema operacional, orquestração de contêineres, envio de logs, rotação de segredos, failover de região e monitoramento de uptime. A TradingHost oferece um ambiente de execução gerenciado e desenvolvido especificamente para estratégias de trading: implantação nativa do GitHub, controle via MCP a partir de IDEs de IA e interfaces integradas de logs e integridade. Se você prefere operar a infraestrutura por conta própria, a AWS atende. Se você quer o ambiente de execução como um serviço gerenciado, a TradingHost é o caminho mais curto.
Sim. O SDK atual de Python da Alpaca é o alpaca-py; o antigo alpaca-trade-api ainda é mantido. Ambos rodam na TradingHost. JavaScript e TypeScript funcionam via alpaca-trade-api-js.
Sim. A TradingHost suporta qualquer linguagem que possa ser executada dentro de um contêiner. A Alpaca disponibiliza o alpaca-trade-api-js para JS e TS; outras linguagens podem chamar os endpoints REST e WebSocket diretamente.
Sim, sujeito à aprovação de opções pela Alpaca. As opções são expostas pela mesma credencial da Trading API usada para ações e cripto. O nível aprovado controla quais estratégias a corretora aceita; a TradingHost não contorna a aprovação de opções.
Sim. O mercado de cripto é fornecido pela Alpaca Crypto LLC, uma empresa de serviços monetários registrada na FinCEN que é uma entidade legal separada da Alpaca Securities LLC. Do ponto de vista da estratégia, a credencial da Trading API é a mesma; sob a perspectiva regulatória, a entidade é distinta.
Conecte seu repositório do GitHub que contém o código da estratégia, vincule-o à TradingHost e faça a implantação. Use um deploy com chaves paper como ambiente de teste e promova para chaves live assim que a estratégia estiver estável. Vincular o GitHub e criar uma estratégia é grátis; os planos de execução estão listados na página de preços.
No seu fluxo de trabalho de segredos controlado pelo GitHub. A TradingHost lê essas chaves em tempo de execução por meio de segredos de repositório do GitHub, segredos de ambiente ou do seu próprio processo aprovado de gerenciamento de segredos. A TradingHost não precisa da custódia do seu APCA-API-KEY-ID e APCA-API-SECRET-KEY. Consulte a seção de segredos da plataforma para entender o modelo completo de tratamento.
Não. As estratégias nunca devem precisar de permissões de saque ou movimentação de dinheiro. A chave de API precisa apenas dos escopos necessários para o envio de ordens e acesso a dados de mercado.
Sim. O TradingHost suporta controle baseado em MCP para IDEs de IA, incluindo Cursor, Claude Code, GitHub Copilot e agentes de IA baseados em CLI. As ferramentas de IA podem inspecionar deploys, revisar logs, reiniciar estratégias e gerenciar fluxos de trabalho de runtime. O MCP é uma superfície de controle e observabilidade, não o caminho de execução de ordens. Veja a superfície de controle MCP para entender o funcionamento completo.
Sim, desde que você os trate como estratégias separadas no TradingHost, com secrets distintos. O ambiente paper da Alpaca utiliza URLs base e chaves diferentes do ambiente live, de modo que os deploys ficam isolados por configuração. O mesmo código-fonte pode rodar em ambos, utilizando variáveis de ambiente diferentes.
Não. A regra PDT (FINRA Rule 4210) é aplicada pela Alpaca, não pelo TradingHost. Contas de margem com saldo inferior a US$ 25.000 estão sujeitas às restrições de PDT para day trading. Sua estratégia deve consultar o endpoint da conta e respeitar a flag pattern_day_trader.
Não. Seus formulários 1099 são fornecidos pela Alpaca no fim do ano, não pelo TradingHost. O TradingHost fornece o runtime; a Alpaca cuida dos relatórios fiscais da corretora.
Não. O SIPC cobre sua conta de corretora na Alpaca (até US$ 500.000, incluindo US$ 250.000 em dinheiro) sob a proteção de membro do SIPC. O runtime do TradingHost não possui seguro SIPC porque o TradingHost não é uma corretora.
O TradingHost é executado nas regiões EU e US-East. A região US-East é a mais próxima dos matching engines de ações dos EUA, sendo a escolha natural para a maioria das estratégias da Alpaca. Consulte a página de regiões para obter detalhes de roteamento e proximidade.
Não. O TradingHost é focado em runtime de produção e deploy. O backtest deve ser feito em sua stack de pesquisa, framework ou no AlgoBuilder.