Polymarket Alpha

Price: $0.50 USDC per call

Endpoint: https://agents.melis.ai/brief/polymarket-alpha

Method: POST

Pays to: 0x1C680703D6cF7dfC9FEABb5AA28E64B869ddB3bC

What it does

Bundle #2, and the most ingredient-rich yet. Cross-source alpha on Polymarket: 24h odds shifts, smart-money wallet activity (KYA-trust-scored, sourced from the live Polymarket trades feed), news catalysts that move odds, and the proprietary signal — which markets the live melis Polymarket bot fleet is actively monitoring across crypto/weather/sports/maker strategies (aggregate universe only; never positions or P&L). Composes 7 audit-verified melis services + 6 public sources, triages with prediction-market-tuned weighting (recency + strategic), and clears the same 10-signal professionalism gate. Charge-on-success-only; immutable shareable snapshot per run; EAS-anchored once the provenance wallet is funded.

When to use it

  • An agent trading prediction markets wants a daily corroborated read on odds shifts + smart-money flow
  • An alpha researcher tracks which markets a live bot fleet is monitoring without seeing its positions
  • A trading agent caches the daily alpha brief and re-reads it free via its payment-hash receipt
  • An agent embeds the immutable snapshot URL in a downstream signal report for verifiable provenance

Request schema

{
  "topic": "live alpha",
  "lookbackHours": 24,
  "format": "html"
}

Response schema

{
  "snapshotUrl": "/brief/polymarket-alpha/snap_6580b5f53ab5",
  "signalsPassed": 10,
  "sourcesConsulted": 9,
  "attestation": {
    "status": "deferred",
    "reason": "provenance wallet pending funding"
  },
  "costUsdc": 0.06
}

Code example — TypeScript via MCP

Install the MCP server once; all 22 services become tool calls.

// Configure @melis-ai/x402-tools-mcp in your MCP client
// Then call the tool:

const result = await mcpClient.callTool("polymarket_alpha", {
  "topic": "live alpha",
  "lookbackHours": 24,
  "format": "html"
});

console.log(result);
// ["snapshotUrl","signalsPassed","sourcesConsulted","attestati...
→ MCP setup guide

Code example — Python via direct HTTP

import requests

# x402 payment header must be set by your wallet client
# See x402.org for client libraries

headers = {
    "Content-Type": "application/json",
    "x-payment": "<signed-x402-payment-header>",
}

resp = requests.post(
    "https://agents.melis.ai/brief/polymarket-alpha",
    json={
      "topic": "live alpha",
      "lookbackHours": 24,
      "format": "html"
    },
    headers=headers,
)
print(resp.json())

Code example — curl with internal key bypass

For testing with an issued internal key (skips x402 payment flow):

curl -X POST https://agents.melis.ai/brief/polymarket-alpha \
  -H "Content-Type: application/json" \
  -H "x-internal-key: YOUR_KEY" \
  -d '{"topic":"live alpha","lookbackHours":24,"format":"html"}'

How is this different from alternatives?

Polymarket Alpha vs Scrape the Polymarket API yourself

You can pull markets and odds from the Gamma API for free. What you cannot replicate is the watched-market universe of a live bot fleet, KYA trust-scoring of the smart money actually trading, and the editorial gate that turns raw odds into a corroborated read.

Polymarket Alpha vs A prediction-market newsletter

Newsletters are human-paced and not machine-consumable per-request. This is a charge-per-brief x402 endpoint an agent calls on demand, with a verifiable immutable snapshot and cross-source provenance.

FAQ

Does it work without an account?

Yes. x402 is account-less. Your agent's wallet signs the payment and retries automatically. No registration, no API key, no subscription.

What happens on failure?

Returns HTTP 502 with no_settlement:true if the brief cannot clear 8/10 professionalism signals after 3 attempts (charge-on-success-only). HTTP 400 no_settlement on a confirmed-unsafe topic (PromptGuard). Source failures degrade gracefully — the ribbon names any source not consulted (e.g. "Twitter rate-limited", "KYA no wallets"). The bot adapter surfaces aggregate market universe only — never trade size, entry price or P&L. Snapshot + receipt URLs are always free and never re-bill.

What is the rate limit?

Cached 10 min; a warmer (every 9 min) keeps the cache hot so agent calls are served instantly. Cold regeneration ~55s.

Is this open-source?

The service code is closed-source for security reasons. The MCP wrapper that calls it is open-source and MIT-licensed: github.com/mizukaizen/x402-tools-mcp .

Who built this?

Part of the melis.ai agent infrastructure stack. Running on a dedicated Helsinki VPS since early 2026. Contact sean@melis.ai.