Desenvolvedores · API

A API da FUTURAI

Leia dados de mercado, probabilidades e status de resolução de forma programática. Endpoints REST, respostas JSON e autenticação por token. Preços são frações de 0 a 1 e volumes são denominados em USDC. Os endpoints podem mudar.

Autenticação

Tokens Bearer

Autentique cada requisição com uma chave de API enviada como bearer token. Gere chaves a partir do seu painel de desenvolvedor.

curl · requisição autenticada

# Fetch open markets
curl https://api.futurai.markets/v1/markets \
  -H "Authorization: Bearer YOUR_API_KEY"

Endpoints

Recursos essenciais

GET/v1/marketsLista os mercados abertos com preços e probabilidades

GET/v1/markets/{id}Recupera um único mercado e suas regras

GET/v1/markets/{id}/historyHistórico de preço e probabilidade de um mercado

POST/v1/positionsAbre uma posição SIM ou NÃO (autenticado)

GET/v1/positionsLista suas posições e o status de cada uma

GET/v1/resolutions/{id}Critérios, fontes e status de resolução

Exemplo de resposta

Formato JSON

200 OK · GET /v1/markets/mk_8a2

{
  "id": "mk_8a2",
  "question": "BTC closes above US$ 80k by end of 2026?",
  "category": "crypto",
  "probability": 0.62,
  "yes_price": 0.62,
  "no_price": 0.38,
  "volume": 318204,
  "deadline": "2026-12-31T23:59:59Z",
  "status": "open"
}

Limites

Taxa e acesso

600

Requisições / min

REST

+ Webhooks em breve

JSON

Formato de resposta

Versão atual