SERVICE / DETAILfinance

Polymarket Intelligence API

GET api.polym.uk/market-authenticity/:conditionId

SONAR SCORE0.636
LIVE PRICE0.050000
BAZAAR LIVEcompatible
CDP INDEXEDno
DECISION EVIDENCE

Why an agent can trust this route.

19 observations in the last 24h
HANDSHAKE SUCCESS100.0%402 challenge reachable
PAID DELIVERY0.0%settlement observed
P90 LATENCY4288msrecent response window
PRICE DRIFT0.0%advertised vs observed

Sonar evidence is advisory. Paid delivery is shown as verified only when paid probes are available; otherwise route estimates use the unpaid handshake as a clearly labeled proxy.

SONAR PROBE HISTORY / 30D

Observed outcomes

JSON ↗
LIVE ENDPOINT METADATA

Per-market Polymarket taker-flow concentration, price-band and book compatibility. Never a fraud verdict. BEFORE YOU PAY: free substitute https://dash.polym.uk/markets.json. THIS ADDS: One market instead of the whole snapshot, when it is decomposed. Outside that set: 422, and no charge.

Resource: api.polym.uk/market-authenticity/:conditionId

Network: eip155:8453 · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0x7b13107779CfDA1bEba3289d0Fbe27310436f3E3

Payment methods: · Last validation: 2026-09-14 16:41:58.845+00

{
  "input": {
    "type": "object",
    "required": [
      "type",
      "method"
    ],
    "properties": {
      "type": {
        "type": "string",
        "const": "http"
      },
      "method": {
        "enum": [
          "GET"
        ],
        "type": "string"
      },
      "pathParams": {
        "type": "object",
        "required": [
          "conditionId"
        ],
        "properties": {
          "conditionId": {
            "type": "string",
            "pattern": "^0x[0-9a-fA-F]{64}$",
            "description": "A market is covered only while it is in the observed window, so any single example ages. Take a covered markets[].conditionId from the free snapshot at https://dash.polym.uk/markets.json, or call GET /coverage (free) for how many markets are decomposed right now. A conditionId outside the covered set returns 422 and is not billed."
          }
        },
        "additionalProperties": false
      },
      "queryParams": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    "additionalProperties": false
  },
  "output": {
    "type": "object",
    "required": [
      "type"
    ],
    "properties": {
      "type": {
        "type": "string"
      },
      "example": {
        "type": "object",
        "oneOf": [
          {
            "type": "object",
            "required": [
              "asOf",
              "windowHours",
              "conditionId",
              "title",
              "found",
              "bucket",
              "marketClosed",
              "apparentVolumeUsd",
              "trades",
              "concentration",
              "priceBand",
              "structure",
              "dominantFlow",
              "resolutionRisk",
              "caveats"
            ],
            "properties": {
              "asOf": {
                "type": "string",
                "format": "date-time"
              },
              "found": {
                "type": "boolean",
                "const": true
              },
              "title": {
                "type": "string"
              },
              "bucket": {
                "enum": [
                  "unranked",
                  "structurally-thin",
                  "concentrated",
                  "moderate",
                  "broad"
                ],
                "type": "string",
                "description": "Descriptive taker-flow structure bucket, not a fraud verdict."
              },
              "trades": {
                "type": "integer",
                "minimum": 0
              },
              "caveats": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "priceBand": {
                "type": "object",
                "required": [
                  "subCentShare",
                  "nearResolutionShare"
                ],
                "properties": {
                  "subCentShare": {
                    "type": "number",
                    "maximum": 1,
                    "minimum": 0
                  },
                  "nearResolutionShare": {
                    "type": "number",
                    "maximum": 1,
                    "minimum": 0
                  }
                },
                "additionalProperties": false
              },
              "structure": {
                "type": "object",
                "required": [
                  "bookLiquidityUsd",
                  "spread",
                  "orderbookEnabled",
                  "rewardsSubsidized",
                  "apparentVsBookFlag",
                  "endDate"
                ],
                "properties": {
                  "spread": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "minimum": 0
                  },
                  "endDate": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "bookLiquidityUsd": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "minimum": 0
                  },
                  "orderbookEnabled": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "rewardsSubsidized": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "apparentVsBookFlag": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  }
                },
                "additionalProperties": false
              },
              "conditionId": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{64}$",
                "description": "Polymarket condition ID."
              },
              "windowHours": {
                "type": "number",
                "minimum": 0
              },
              "dominantFlow": {
                "type": [
                  "object",
                  "null"
                ],
                "required": [
                  "wallet",
                  "side",
                  "outcome",
                  "vwap",
                  "notionalUsd",
                  "walletMarkets",
                  "distinctCounterparties",
                  "counterpartyHhi",
                  "effectiveCounterparties",
                  "sampledFills",
                  "betResolvedInFavor"
                ],
                "properties": {
                  "side": {
                    "enum": [
                      "BUY",
                      "SELL"
                    ],
                    "type": "string"
                  },
                  "vwap": {
                    "type": "number",
                    "maximum": 1,
                    "minimum": 0
                  },
                  "wallet": {
                    "type": "string"
                  },
                  "outcome": {
                    "type": "string"
                  },
                  "notionalUsd": {
                    "type": "number",
                    "minimum": 0
                  },
                  "sampledFills": {
                    "type": [
                      "integer",
                      "null"
                    ],
                    "minimum": 0
                  },
                  "walletMarkets": {
                    "type": [
                      "integer",
                      "null"
                    ],
                    "minimum": 0
                  },
                  "counterpartyHhi": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "minimum": 0
                  },
                  "betResolvedInFavor": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "distinctCounterparties": {
                    "type": [
                      "integer",
                      "null"
                    ],
                    "minimum": 0
                  },
                  "effectiveCounterparties": {
                    "type": [
                      "integer",
                      "null"
                    ],
                    "minimum": 0
                  }
                },
                "additionalProperties": false
              },
              "marketClosed": {
                "type": [
                  "boolean",
                  "null"
                ]
              },
              "concentration": {
                "type": "object",
                "required": [
                  "topTraderShare",
                  "hhi",
                  "effectiveTraders",
                  "distinctTraders"
                ],
                "properties": {
                  "hhi": {
                    "type": "number",
                    "maximum": 1,
                    "minimum": 0
                  },
                  "topTraderShare": {
                    "type": "number",
                    "maximum": 1,
                    "minimum": 0
                  },
                  "distinctTraders": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "effectiveTraders": {
                    "type": "integer",
                    "minimum": 0
                  }
                },
                "additionalProperties": false
              },
              "resolutionRisk": {
                "type": [
                  "object",
                  "null"
                ],
                "required": [
                  "category",
                  "categoryDisputeRatePct",
                  "categoryDisputeSample",
                  "categoryInsufficientSample",
                  "categoryElevated",
                  "titleLooksCheckable",
                  "categoryFlipRatePct",
                  "flipInsufficientSample"
                ],
                "properties": {
                  "category": {
                    "type": "string"
                  },
                  "categoryElevated": {
                    "type": "boolean"
                  },
                  "categoryFlipRatePct": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "maximum": 100,
                    "minimum": 0
                  },
                  "titleLooksCheckable": {
                    "type": "boolean"
                  },
                  "categoryDisputeSample": {
                    "type": "string"
                  },
                  "categoryDisputeRatePct": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "maximum": 100,
                    "minimum": 0
                  },
                  "flipInsufficientSample": {
                    "type": "boolean"
                  },
                  "categoryInsufficientSample": {
                    "type": "boolean"
                  }
                },
                "additionalProperties": false
              },
              "apparentVolumeUsd": {
                "type": "number",
                "minimum": 0
              }
            },
            "additionalProperties": false
          },
          {
            "type": "object",
            "required": [
              "asOf",
              "conditionId",
              "found",
              "note",
              "caveats"
            ],
            "properties": {
              "asOf": {
                "type": "string",
                "format": "date-time"
              },
              "note": {
                "type": "string"
              },
              "found": {
                "type": "boolean",
                "const": false
              },
              "caveats": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "conditionId": {
                "type": "string",
                "pattern": "^0x[0-9a-fA-F]{64}$"
              }
            },
            "additionalProperties": false
          }
        ]
      }
    }
  },
  "paymentRequirements": [
    {
      "raw": {
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "extra": {
          "name": "USD Coin",
          "iconUrl": "https://polym.uk/favicon.svg",
          "version": "2"
        },
        "payTo": "0x7b13107779CfDA1bEba3289d0Fbe27310436f3E3",
        "amount": "50000",
        "scheme": "exact",
        "network": "eip155:8453",
        "maxTimeoutSeconds": 300
      },
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x7b13107779CfDA1bEba3289d0Fbe27310436f3E3",
      "scheme": "exact",
      "network": "eip155:8453",
      "amountAtomic": "50000"
    }
  ]
}
METADATA PROVENANCE

Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.