Resolved Markets MCP

npx add-mcp 'https://mcp.resolvedmarkets.com/mcp'

Agentes de IA em dados da Polymarket — MCP, OpenAPI e llms.txt

A Resolved Markets fornece tudo o que um agente de codificação autônomo ou assistente de chat precisa para chamar nossa API corretamente na primeira tentativa: um servidor nativo do Model Context Protocol, uma especificação completa OpenAPI 3.1 e dois arquivos de referência em markdown otimizados para LLM. Basta adicioná-los ao Claude, ChatGPT, Gemini, Cursor, Windsurf, LangChain, CrewAI ou qualquer outra ferramenta que suporte tool-use.

Três caminhos de integração

Todos os três usam a mesma chave de API rm_. Escolha o que melhor se adequa ao runtime que você está configurando.

1. MCP nativo (Claude Desktop, Claude Code, Cursor, Windsurf, Cline)

O servidor MCP da Resolved Markets expõe quatorze ferramentas — descoberta (list_categories, list_markets, list_historical_markets, get_market, get_market_metadata), livro de ofertas e histórico (get_orderbook, get_snapshot, get_latest_snapshots, query_snapshots, get_trades, get_market_summary), exchange (get_exchange_orderbook, get_exchange_snapshots) e get_system_stats — além de três recursos (markets://live, prices://latest, reference://catalog). Configure uma vez, e qualquer cliente compatível com MCP poderá chamá-los como ferramentas de primeira classe, sem código adicional.

# Claude Desktop / Claude Code config (claude_desktop_config.json)
{
  "mcpServers": {
    "resolved-markets": {
      "command": "npx",
      "args": ["-y", "@elcara-hq/resolvedmarkets-mcp"],
      "env": {
        "HF_API_URL": "https://api.resolvedmarkets.com",
        "HF_API_KEY": "rm_your_key_here"
      }
    }
  }
}

O transporte HTTP também é suportado (MCP_TRANSPORT=http MCP_PORT=3002) para agentes self-hosted que preferem MCP remoto em vez de stdio.

2. Tool-use / function-calling com a especificação OpenAPI

A especificação OpenAPI 3.1 em https://resolvedmarkets.com/openapi.json pode ser importada no Postman, Insomnia, RapidAPI, GPT Actions ou em qualquer gerador de código. Para tool-use da Anthropic e da OpenAI, exponha as operações da especificação como definições de ferramentas e o modelo produzirá chamadas tipadas automaticamente.

# Python — load the spec into an OpenAI function-calling tool
import requests, json

spec = requests.get("https://resolvedmarkets.com/openapi.json").json()
tools = []
for path, ops in spec["paths"].items():
    for method, op in ops.items():
        tools.append({
            "type": "function",
            "function": {
                "name": op["operationId"],
                "description": op.get("summary", ""),
                "parameters": op.get("requestBody", {}).get("content", {})
                  .get("application/json", {}).get("schema", {}),
            },
        })

3. Contexto simples — cole o llms.txt no system prompt

Para assistentes de chat sem tool-use (ou para perguntas pontuais), cole /llms.txt (resumo de ~10 KB) ou /llms-full.txt (referência completa de ~43 KB) no system prompt. O modelo poderá então responder perguntas sobre endpoints, parâmetros e formatos de resposta — e gerar curl ou Python corretos que acessam URLs reais.

System prompt pronto para uso

Copie isto no system prompt de qualquer LLM para dar a ele conhecimento fundamentado sobre a API da Resolved Markets. O agente citará os endpoints corretos e deixará de inventar rotas.

You have access to live and historical Polymarket prediction market and Hyperliquid perpetual futures orderbook data via the Resolved Markets API.

API base URL: https://api.resolvedmarkets.com
Authentication: header "X-API-Key: rm_..." (the user will provide their key)

Reference docs (read these first if you need details):
- Short reference: https://resolvedmarkets.com/llms.txt
- Full reference: https://resolvedmarkets.com/llms-full.txt
- OpenAPI spec: https://resolvedmarkets.com/openapi.json

Coverage: crypto (BTC, ETH, SOL, XRP, DOGE, HYPE, BNB), weather (daily temperature in 51 cities, hurricanes, climate), sports (NBA, NFL, EPL, ATP, WTA, IPL, FIFA World Cup), economics (FOMC, NFP), equities, and Hyperliquid perpetual futures. Snapshots include full bid/ask depth, mid, spread, sequence numbers, and the paired crypto spot price at capture time.

When answering questions about Polymarket markets, prefer calling these endpoints over guessing:
- GET /v1/markets/live           — list active markets (filter with ?category= and ?subcategory=)
- GET /v1/markets/:id/orderbook  — live UP and DOWN orderbook for a market
- GET /v1/markets/:id/snapshots  — historical snapshots (?from= ?to= ?limit=500)
- GET /v1/markets/:id/summary    — aggregated stats: spread, depth, price range
- GET /v1/public-stats           — platform-wide stats (no auth required)

Probabilities are USDC prices in 0.01..0.99. Each market has UP and DOWN tokens; UP + DOWN ≈ 1.00.

Runtimes compatíveis

• Clientes nativos MCP — Claude Desktop, Claude Code, Cursor, Windsurf, Cline, Continue, Zed.
• SDK Anthropic — tool-use com as operações OpenAPI como definições de ferramentas.
• SDK OpenAI — function calling, GPT Actions para GPTs personalizados do ChatGPT.
• SDK Google AI — Gemini function calling.
• Frameworks — LangChain, LlamaIndex, CrewAI, AutoGen, Haystack, Semantic Kernel.
• HTTP simples — qualquer coisa que possa enviar X-API-Key e analisar JSON.

Início rápido em 60 segundos (Python)

import os, requests

BASE = "https://api.resolvedmarkets.com"
H = {"X-API-Key": os.environ["RM_API_KEY"]}

# 1. Find an active BTC market
markets = requests.get(f"{BASE}/v1/markets/live",
                       params={"category": "crypto", "subcategory": "BTC"},
                       headers=H).json()
market_id = markets["markets"][0]["condition_id"]

# 2. Pull live orderbook
ob = requests.get(f"{BASE}/v1/markets/{market_id}/orderbook", headers=H).json()
print(ob["up"]["best_bid"], ob["up"]["best_ask"])

# 3. Pull last hour of snapshots
snaps = requests.get(f"{BASE}/v1/markets/{market_id}/snapshots",
                     params={"limit": 500}, headers=H).json()

Perguntas frequentes

Como os agentes de IA chamam a API da Resolved Markets?

Três opções. (1) MCP nativo — aponte o Claude Desktop, Claude Code ou qualquer agente compatível com MCP para nosso servidor MCP (stdio ou HTTP) e o agente chamará list_markets, get_orderbook, get_snapshot, query_snapshots, get_market_summary e get_system_stats como ferramentas, sem código adicional. (2) Tool-use / function calling — forneça ao agente nossa especificação OpenAPI em https://resolvedmarkets.com/openapi.json e deixe-o gerar chamadas REST. (3) Contexto simples — cole https://resolvedmarkets.com/llms-full.txt no system prompt e o modelo poderá responder perguntas sobre endpoints, parâmetros e formatos de resposta diretamente.

Quais frameworks de agentes são suportados?

Qualquer coisa que fale MCP (Claude Desktop, Claude Code, Cursor, Windsurf, Cline, Continue) funciona de imediato. Qualquer coisa que fale OpenAI tool-use, Anthropic tool-use, Gemini function calling, LangChain, LlamaIndex, CrewAI, AutoGen ou clientes HTTP personalizados pode usar a API REST diretamente com a especificação OpenAPI.

Preciso de uma chave de API separada para MCP?

Não. A mesma chave de API rm_ funciona para REST, WebSocket e MCP. Defina HF_API_KEY=rm_your_key no ambiente do seu servidor MCP.

Como faço meu agente de IA citar informações corretas de endpoints?

Cole o conteúdo de https://resolvedmarkets.com/llms.txt ou https://resolvedmarkets.com/llms-full.txt no system prompt do agente. Ambos os arquivos são markdown simples otimizados para janelas de contexto de LLM. O llms.txt mais curto (~10 KB) cobre o básico; o llms-full.txt (~43 KB) inclui todos os endpoints, todos os parâmetros e exemplos de código.

Existe uma especificação OpenAPI?

Sim — OpenAPI 3.1 em https://resolvedmarkets.com/openapi.json.. Importe-a no Postman, Insomnia, RapidAPI, GPT Actions, Cursor ou em qualquer gerador de código para criar um cliente tipado em segundos.

As solicitações MCP contarão para meu limite de taxa?

Sim — MCP e REST compartilham o mesmo limite de taxa por chave e o mesmo orçamento de créditos. Gratuito: 300 req/min, histórico ilimitado, MCP completo, 5K créditos/mês. Pro: 300 req/min, 50K créditos, MCP completo. Scale: 1.000 req/min, 500K créditos, todas as categorias. Enterprise: 3.000 req/min, 5M créditos.