Docs

Get started

Surplus lines market data, per query. QueryLines is a REST API (and an MCP server) for U.S. excess & surplus insurance statistics. Three endpoints are free with no key and no payment; everything else is paid per call with USDC on Base via x402, no account required.

Three ways in

REST + x402

Plain HTTP. Free endpoints return data immediately; paid endpoints return an HTTP 402 payment challenge that an x402-capable client settles in USDC on Base and retries. See Pay per query for the full flow, official SDKs, and a funded-wallet walkthrough (one path for developers, one for people who have never touched crypto).

MCP

Connect an MCP client (Claude, ChatGPT, Microsoft 365 Copilot, Cursor, or any other) to https://api.querylines.com/mcp and get the same data as seven typed tools. The three free tools work in any client with zero setup. See Use from your assistant for per-client setup.

Free discovery endpoints

/v1/premium/sample, /v1/coverage, and /v1/lines require no account, no key, and no payment. They're the fastest way to see the real shape of the data before spending anything: the examples below hit them live.

Start free, no payment

These three calls work exactly as shown, right now, from a terminal or a browser. No API key, no wallet, no x402 client.

`GET /v1/premium/sample`

Statewide, all coverage lines, latest 13 months. This is the exact endpoint the live chart on the homepage renders from.

curl

$ curl -s "https://api.querylines.com/v1/premium/sample?state=FL"

200 response (abridged)

{
  "state": "FL",
  "line": "all",
  "granularity": "month",
  "sample": true,
  "data": [
    { "period": "2025-05", "premium": 1886556336, "policy_count": 151452 },
    // … 2025-06 … 2026-04 …
    { "period": "2026-05", "premium": 1674439815, "policy_count": 177627 },
    { "period": "2026-06", "premium": 1877013891, "policy_count": 204624 }
  ],
  // new_business_premium, renewal_premium, new_business_policy_pct,
  // renewal_policy_pct also present per period; omitted here for length
  "report_date": "2026-06-30",
  "data_as_of": "2026-06",
  "source": "FSLSO FL Monthly Premium Report, June 2026",
  "note": "Free sample: statewide all-lines monthly series, latest 13 months…"
}

`GET /v1/coverage`

What data exists: states, date ranges, granularities, and dimensions.

curl

$ curl -s "https://api.querylines.com/v1/coverage"

200 response

[
  {
    "state": "FL",
    "name": "Florida",
    "period_types": {
      "month": { "from": "2025-01", "to": "2026-06" },
      "year": { "from": "2025", "to": "2025" }
    },
    "capabilities": { "has_county_data": true, "has_insurer_data": true, "has_new_renewal_split": true }
  },
  {
    "state": "TX",
    "name": "Texas",
    "period_types": {
      "month": { "from": "2016-01", "to": "2026-06" },
      "year": { "from": "2009", "to": "2025" }
    },
    "capabilities": { "has_county_data": false, "has_insurer_data": true, "has_new_renewal_split": false }
  }
]

See API reference & data for the always-current, live-rendered version of this table.

`GET /v1/lines`

Coverage-line taxonomy for a state: the values valid for line= on paid endpoints.

curl

$ curl -s "https://api.querylines.com/v1/lines?state=FL"

200 response (abridged, 16 lines total)

[
  { "id": 1, "source_code": "COMMERCIAL PROPERTY", "name": "COMMERCIAL PROPERTY", "category": "property" },
  { "id": 2, "source_code": "COMMERCIAL GENERAL LIABILITY", "name": "COMMERCIAL GENERAL LIABILITY", "category": "liability" },
  { "id": 5, "source_code": "HOMEOWNERS-HO-3", "name": "HOMEOWNERS-HO-3", "category": "property" },
  { "id": 10, "source_code": "CYBER LIABILITY", "name": "CYBER LIABILITY", "category": "cyber" },
  // … 12 more: builders risk, commercial auto, package, umbrella, E&O,
  // flood, windstorm/hail, ocean marine, and uncategorized lines …
]

Where to go next

Pay per query: a funded wallet in five minutes (no code required for that part), official SDKs for TypeScript, Python, and Go, and the 402 flow end to end.
Use from your assistant: connect Claude, Cursor, or any MCP client; the full tool and price table.
API reference & data: every endpoint, live from /openapi.json, plus data semantics (attribution, restatements, data_as_of).
Not writing code? Read a market snapshot instead: same data, no API key.