Groundtruth

xyz.groundtruthsPublished by groundtruths.xyzOfficial publisherv2.0.0Updated Nov 7, 2026

Who is buying the prediction-market line: Polymarket wallet records, board, edges, entries.

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Remote MCP server exposing Polymarket prediction-market data: market boards, wallet records, line gaps, smart-money entries and heat scores.

What you can do
  • View the market board of Polymarket games and US midterm races, with sides, price, dollars, wallets and tagged holders
  • Check who is buying a line, including per-market heat scores and a line-check board with pre-start stamp hashes
  • Find markets where the GT line and Smart-money line differ by 3+ points, with the fills and wallets behind each
  • Read the smart-money entry feed with wallet, side, size, price, lag and whether it was logged live or rebuilt
  • Look up a Polygon wallet's record: won X of Y, P&L, category split and tag
When to use it
Useful when you want an assistant to look up who is holding or moving a Polymarket position, compare a market's line against tracked smart money, or check a wallet's track record before acting on it. Free tiers cover a few top rows per board; full data needs payment or a key.
Requirements
Remote streamable HTTP endpoint; no local install. No authentication is required for the free rows. Full data needs either a paid x-api-key header or per-call x402 payment in USDC on Base or Solana, plus an x402-capable client to sign the payment payload.
Before you install
Paid routes cost USDC per call (for example $0.05 for the board or entries feed, $0.01 for a wallet record), and the wallet record is paid only. Paying requires signing a payment authorization with a wallet. Data is information only, not financial advice, and a wallet record belongs to a wallet, not a person.

Installation

In SourceWeft

  1. Open Groundtruth in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/xyz.groundtruths%2Fgroundtruth/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "groundtruth": {
      "type": "http",
      "url": "https://api.groundtruths.xyz/mcp"
    }
  }
}

README

GROUNDTRUTH MCP + x402

Who is buying the prediction-market line. Polymarket wallet records, the market board (who is in, per market), GT line vs Smart-money line gaps, and the smart-money entry feed. Counts from the Polygon chain, each with its sample size. Paid per call over x402 (USDC on Base or Solana), or free to connect over MCP.

The memecoin tools are paused; everything below is prediction-market data.

Price table

routewhatprice (USDC)free
/x402/v1/pm/wallet?addr=0x..one wallet's record: won X of Y, P&L, tag$0.01none
/x402/v1/pm/boardwho is in, per market$0.05top 3 per board
/x402/v1/pm/edgesGT line vs Smart-money line gaps$0.03top 3
/x402/v1/pm/entriessmart-money entries$0.05newest 3

/x402/... is the always-402 door a bazaar validator probes. /v1/pm/... answers the free rows without a payment and a 402 for the rest. Same prices, one constant in the worker.

1. Unpaid: the 402 challenge

bash
curl -i 'https://api.groundtruths.xyz/x402/v1/pm/board'

2. Paid: the board

Sign the requirement and send the payload back in PAYMENT-SIGNATURE (any x402 client does this; @x402/fetch works):

bash
curl -s -H 'PAYMENT-SIGNATURE: <base64 payload>' 'https://api.groundtruths.xyz/x402/v1/pm/board'

Each market comes back with its sides, price, $ and wallets, the tagged wallets holding each side (SMART MONEY / WHALE / BOT/MM), the GT line and the Smart-money line. No sportsbook odds and no Kalshi price ever ride these routes.

3. Paying

  • Base (eip155:8453): USDC, EIP-3009 transferWithAuthorization. A signed message: the payer needs no ETH.
  • Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp): USDC SPL transfer with the facilitator as fee payer, so the payer needs no SOL. Exactly three instructions in order: SetComputeUnitLimit, SetComputeUnitPrice, transfer.

4. MCP client config

json
{  "mcpServers": {    "groundtruth": {      "type": "streamable-http",      "url": "https://api.groundtruths.xyz/mcp"    }  }}

Tools: pm_market_board, pm_edges, pm_smart_money_entries, pm_wallet_record, line_check_board, market_heat. Optional header x-api-key: gt_live_... (free key: https://groundtruths.xyz/account). Without a key: the free rows.

5. Bankr

install the skill at https://github.com/groundtruth-now/groundtruth-mcp/tree/main/skills/groundtruth

Facilitators

Per chain, because bazaars index per facilitator: Base -> CDP, Solana -> PayAI.

How we keep score

https://groundtruths.xyz/boring#linecheck. A record belongs to a wallet, not a person. Information only, not financial advice.

Source: README.md at commit ad1640e

Tools

6

line_check_board

LINE CHECK: who is buying the prediction-market line. Polymarket games starting in the next 72 h and the US midterm race board (Nov 3): per market, the side with the most fresh-or-clustered money, its $ and wallets (k of N), price, HEAT 0-100 with its N, and the pre-start stamp hash. Counts from the Polygon chain. Information only, not financial advice.

Takes no parameters.

market_heat

HEAT for one Polymarket market (condition id): the share of a side's $ from fresh or clustered wallets, ranked 0-100 against sides with real money (>= $1,000 on the side and some fresh-or-clustered $), with N. heat is null (with the reason) when the market has none. Information only, not financial advice.

Parameterscidrequired

pm_market_board

GROUNDTRUTH market board: who is in on Polymarket games and US midterm races. Per market: sides, price, $, wallets, tagged holders, GT line and Smart-money line. Top 3 per board free; a paid key or x402 (https://api.groundtruths.xyz/x402/v1/pm/board) returns every market. Information only, not financial advice.

Takes no parameters.

pm_edges

Markets where GT line and the Smart-money line sit 3+ points apart on the same side, with the fills and wallets behind each. Top 3 free; the rest paid. A gap is not a call.

Takes no parameters.

pm_smart_money_entries

Smart-money entry feed: wallet, side, $, price, time, lag, and whether GT logged it live, late, or rebuilt it afterwards. Newest 3 free; the rest paid.

Parametersn

pm_wallet_record

A Polygon (Polymarket) wallet's record: won X of Y with the sample size, P&L (labelled GT audited or Polymarket receipt), category split, tag. Paid only (x402 https://api.groundtruths.xyz/x402/v1/pm/wallet?addr= or a paid key). A record belongs to a wallet, not a person.

Parametersaddrrequired

Version history

3
  1. v2.0.0LatestNov 7, 2026
  2. v1.3.0Oct 1, 2026
  3. v1.0.0Sep 19, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts