API pública para acessar mercados de previsão, preços, atividade e dados em tempo real da plataforma Odd. Endpoints de leitura são públicos. Endpoints de escrita (ordens, comentários, watchlist) requerem autenticação.
https://odd.com.br/apiTodas as respostas são JSON. UTF-8. Datas em ISO 8601.
27
Endpoints
2
Ativos
25
Em desenvolvimento
/api/marketsAtivo/api/markets/{slug}Ativo/api/markets/{slug}/pricesBreve/api/markets/{slug}/activityBreve/api/ordersPlan./api/ordersPlan./api/orders/{id}Plan./api/orders/{id}Plan./api/walletPlan./api/wallet/depositPlan./api/wallet/withdrawPlan./api/wallet/transactionsPlan./api/portfolioPlan./api/portfolio/closedPlan./api/portfolio/performancePlan./api/commentsBreve/api/commentsBreve/api/comments/{id}/likePlan./api/watchlistPlan./api/watchlist/{market_id}Plan./api/watchlist/{market_id}Plan./api/notificationsPlan./api/notifications/{id}Plan./api/users/{handle}Plan./api/leaderboardPlan./api/users/{handle}/followPlan./api/searchPlan.Endpoints marcados com Auth requerem token JWT no header:
Authorization: Bearer <token>
# Obtenha seu token via login:
POST /api/auth/token
Content-Type: application/json
{ "provider": "clerk" }Rate limit: 100 req/min (leitura), 30 req/min (escrita). Headers X-RateLimit-* informam consumo.
Pergunta binária ou multi-opção com preço, volume e probabilidades.
Opção dentro de um mercado multi-opção (ex: candidatos).
Ordem de compra ou venda, market ou limit.
R$ 0,78 = 78% de probabilidade. Contratos resolvem a R$ 1,00 (correto) ou R$ 0,00 (incorreto).
Mercados binários têm Sim/Não com preços complementares. Multi-opção tem N outcomes onde as probabilidades somam 100%.
2% sobre o valor da operação. A taxa é proporcional à incerteza — menor nos extremos de probabilidade.
Mercados são resolvidos com base em fontes oficiais definidas nas regras. Período de contestação de 48h após resolução.
Consulte mercados ativos, filtros, busca e detalhes completos.
/api/marketsLista mercados com filtros, ordenação, busca e paginação por cursor.
categorystringFiltrar por categoria (Economia, Futebol, Política, etc.)statusstringFiltrar por status (active, live, closing, resolved_yes, resolved_no)tabstringFiltro rápido (trending, new, popular, liquid, closing, disputed, brazil)sortstringOrdenação: relevance (padrão), volume, variation, resolution, newestsearchstringBusca por título ou subtítulo (case-insensitive)limitnumberResultados por página (1-50, padrão 20)cursorstringID do último item para paginação{
"markets": [
{
"id": "uuid",
"slug": "selic-sobe-maio-2026",
"title": "Selic sobe na reunião do Copom?",
"category": "Economia",
"type": "binary",
"status": "active",
"priceYes": 0.78,
"priceNo": 0.22,
"variation24h": 0.032,
"volume": 2100000,
"commentCount": 84,
"resolutionDate": "2026-05-07",
"featured": true,
"outcomes": [],
"sport": null,
"crypto": null
}
],
"total": 12,
"hasMore": false
}/api/markets/{slug}Retorna mercado completo por slug com outcomes, dados esportivos/crypto e histórico de preços.
slugstringobrigatórioSlug do mercado (path parameter){
"id": "uuid",
"slug": "selic-sobe-maio-2026",
"title": "Selic sobe na reunião do Copom?",
"priceYes": 0.78,
"priceNo": 0.22,
"context": "Análise detalhada...",
"rules": "Regras de resolução...",
"source": "Banco Central do Brasil",
"priceHistory": [
{
"priceYes": 0.77,
"priceNo": 0.23,
"volumeDelta": 33267,
"recordedAt": "2026-03-26T12:00:00Z"
}
]
}/api/markets/{slug}/pricesHistórico de preços com filtro por período. Suporta intervalos de 1h a todo o histórico.
slugstringobrigatórioSlug do mercadoperiodstringPeríodo: 1h, 6h, 24h, 7d, 30d, all (padrão: 7d)fidelitynumberIntervalo em minutos entre pontos (padrão: auto)/api/markets/{slug}/activityFeed de atividade recente do mercado (compras, vendas, volume).
Crie, consulte e cancele ordens de compra e venda.
/api/ordersCria uma nova ordem de compra ou venda. Suporta ordens market e limit.
market_iduuidobrigatórioID do mercadooutcome_iduuidID do outcome (para mercados multi-opção)sidestringobrigatórioLado da operação: yes ou notypestringobrigatórioTipo: market ou limitpricenumberobrigatórioPreço (0.01 a 0.99)quantitynumberobrigatórioQuantidade de contratos (mínimo 1)/api/ordersLista ordens do usuário autenticado com filtros por status e mercado.
/api/orders/{id}Detalhes de uma ordem específica.
/api/orders/{id}Cancela uma ordem pendente.
Consulte saldo, faça depósitos e saques via Pix.
/api/walletRetorna saldo e histórico resumido da carteira do usuário.
/api/wallet/depositInicia depósito via Pix. Retorna QR code e código copia-e-cola.
amountnumberobrigatórioValor em R$ (mínimo 5, máximo 50.000)/api/wallet/withdrawSolicita saque via Pix para chave cadastrada.
amountnumberobrigatórioValor em R$ (mínimo 10, máximo 50.000)pix_keystringobrigatórioChave Pix de destino/api/wallet/transactionsHistórico completo de transações (depósitos, saques, trades, taxas).
Visualize posições abertas, fechadas e métricas de performance.
/api/portfolioPosições abertas do usuário com PnL e valor atual.
/api/portfolio/closedHistórico de posições encerradas.
/api/portfolio/performanceMétricas de performance: PnL total, win rate, ROI, volume negociado.
Discussões em mercados. Leitura pública, escrita autenticada.
/api/commentsLista comentários de um mercado, ordenados por relevância ou data.
market_iduuidobrigatórioID do mercadosortstringOrdenação: relevant (padrão), recentlimitnumberLimite (padrão 20, máximo 50)/api/commentsPublica um novo comentário em um mercado.
market_iduuidobrigatórioID do mercadotextstringobrigatórioTexto do comentário (1-2000 caracteres)/api/comments/{id}/likeCurte ou descurte um comentário (toggle).
Gerencie mercados salvos e preferências de notificação.
/api/watchlistLista mercados salvos pelo usuário.
/api/watchlist/{market_id}Adiciona mercado à watchlist.
/api/watchlist/{market_id}Remove mercado da watchlist.
/api/notificationsLista notificações do usuário (trades, resoluções, alertas).
/api/notifications/{id}Marca notificação como lida.
Conexão em tempo real para preços, atividade e scores esportivos.
wss://odd.com.br/ws/marketPreços ao vivo, order book, resoluçõeswss://odd.com.br/ws/userOrdens, trades, notificações (auth)wss://odd.com.br/ws/sportsScores ao vivo, estado de jogosTypeScript / JavaScript
npm install @odd/clientPython
pip install odd-clientOpenAPI Spec
odd.com.br/api/openapi.yamlOdd API v0.1.0 — Documentação atualizada em março 2026