Guia da API da Predict.fun: Conecte um Bot em 5 Passos

Autenticação: API key emitida nas configurações da conta, enviada como header.
Leitura: REST para mercados e escadas; um stream do livro para atualizações ao vivo.
Operação: Ordens limitadas e taker por ação, tick 0.01.
Taxa de taker: 0.018 x min(p, 1-p) por ação, cobrada em ações do resultado. Makers não pagam nada.
Liquidação: Uma leitura pontual do preço do oráculo em cada limite. Sem média. Empates pagam 50/50.
Geografia: Bloqueia os EUA.
Docs: docs.predict.fun

Trabalhando com um assistente de IA?

Este briefing explica a um assistente como a Predict.fun autentica, qual é a fórmula da taxa e onde estão as armadilhas. Copie, cole e depois faça sua pergunta.

Mostrar o prompt

Me ajude a conectar um bot de trading à API da Predict.fun. Contexto: os mercados curtos de cripto up/down liquidam por uma leitura pontual do stream de preços da Chainlink em cada limite de janela (sem média), as janelas se encadeiam exatamente, de modo que o preço final de uma janela é o preço inicial da seguinte, e empates pagam 50/50. Mostre: autenticar com uma API key, listar os mercados atuais de 5 e 15 minutos, ler a escada do livro de ofertas, enviar uma compra taker e ler minhas execuções. Armadilhas: a taxa de taker é 0.018 x min(p, 1-p) por ação e é cobrada em ações do resultado, makers não pagam nada, o livro fica quase todo de um lado só no último minuto, e um rebate de maker de 25 por cento mais um programa de pontos não tem valor em dinheiro anunciado. Me indique a documentação oficial para os caminhos exatos dos endpoints. Source: thebotledger.com/api/predict-fun

Cinco passos, simplificados. Os nomes dos endpoints abaixo são marcadores para o formato de cada chamada; pegue os caminhos exatos na referência, que muda com mais frequência do que nas exchanges maiores.

Autentique

import requests
BASE = "https://api.predict.fun"          # confirme na documentação
H = {"X-API-Key": API_KEY}

Liste as janelas atuais

markets = requests.get(f"{BASE}/markets", params={"category": "crypto", "status": "open"}, headers=H).json()
m = next(x for x in markets if x["timeframe"] == "5m" and x["asset"] == "BTC")
start_price = m["startPrice"]              # a abertura declarada, exata ao tick

As janelas se encadeiam: o preço final de uma janela é o preço inicial da seguinte. Se o seu próprio feed spot discordar do preço inicial declarado, confie no declarado.

Leia a escada
```
book = requests.get(f"{BASE}/markets/{m['id']}/orderbook", headers=H).json()
best_ask = book["asks"][0]                 # [price, size]
best_bid = book["bids"][0]
```
No último minuto quase todo negócio agride a oferta ou bate no bid; nada é negociado dentro do spread. Modele suas execuções no toque, não no meio.

Envie uma compra taker

order = {"marketId": m["id"], "outcome": "UP", "side": "BUY", "type": "LIMIT",
         "price": best_ask[0], "size": 30, "timeInForce": "FOK"}
r = requests.post(f"{BASE}/orders", json=order, headers=H).json()

A taxa sai das ações que você recebe, então uma compra de 30 ações a 50 centavos entrega cerca de 29,7 ações.

Leia as execuções

fills = requests.get(f"{BASE}/fills", headers=H).json()

A liquidação é a diferença

Polymarket, Limitless e Kalshi liquidam os mercados curtos de cripto por uma média do último minuto. A Predict.fun liquida por uma única leitura. Em janelas estáveis as duas regras discordam em cerca de uma vez em dez, então não misture resultados da Predict.fun com os das outras, e não leve um modelo treinado nas outras para cá sem retreinar.