api.seneschal.space

Live 402 challenge

Captured by the enrichment pass, not read just now. Prices can change — always read the 402 the endpoint answers with.

{
  "seneschal": {
    "live": {
      "note": "A live taste of the free builder leaderboard — the full board is free; per-builder bid detail + CSV are the paid feeds above.",
      "as_of_ms": 1789366512970,
      "top_builder_24h": {
        "builder": "beaverbuild",
        "share_pct": 57,
        "slots_won": 4094
      }
    },
    "note": "402 means this endpoint is priced (x402 / USDC on Base) — not broken. Pay per call: no account, no API key, no signup. Free tiers and discovery below.",
    "discover": {
      "mcp": "https://mcp.seneschal.space",
      "docs": "https://docs.seneschal.space",
      "openapi": "https://api.seneschal.space/openapi.json",
      "agent_directory": "https://seneschal.space/.well-known/agent.gopher"
    },
    "products": [
      {
        "name": "Private Watch",
        "what": "Monero / Zcash view-key payment webhooks — HMAC-signed, no node to run.",
        "start": "https://api.seneschal.space/v1/private/info"
      },
      {
        "name": "Builder data",
        "what": "Per-builder bid distribution + a downloadable CSV of per-slot bids.",
        "start": "https://api.seneschal.space/v1/premium/builder-stats"
      },
      {
        "name": "Penny Oracle",
        "what": "Atomic DeFi / builder facts, a few cents a call, safe in a tight agent loop.",
        "start": "https://api.seneschal.space/v1/q"
      }
    ],
    "board_cta": "Need data we don't list yet? Post a FREE request at https://api.seneschal.space/v1/board/data-requests — boost it with USDC to jump the queue.",
    "free_to_try": {
      "status": "https://api.seneschal.space/v1/status",
      "notice_board": "https://api.seneschal.space/v1/board",
      "at_risk_borrowers": "https://api.seneschal.space/v1/liquidations/atrisk",
      "builder_leaderboard": "https://api.seneschal.space/v1/builders/leaderboard",
      "penny_oracle_catalogue": "https://api.seneschal.space/v1/q"
    }
  }
}

Accepts

The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.

[
  {
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "extra": {
      "name": "USD Coin",
      "version": "2"
    },
    "payTo": "0x46Ba634261566CF242c853d1f49511f9268ba674",
    "amount": "50000",
    "scheme": "exact",
    "network": "eip155:8453",
    "maxTimeoutSeconds": 120
  }
]

Extensions

{
  "bazaar": {
    "info": {
      "input": {
        "type": "http",
        "method": "GET",
        "queryParams": {
          "blocks": 300,
          "format": "csv",
          "newest": "latest"
        }
      },
      "output": {
        "type": "json",
        "example": "block,base_fee_wei,base_fee_gwei,gas_used_ratio,blob_base_fee_wei,blob_base_fee_gwei,blob_gas_used_ratio\n23012001,747213960,0.74721396,0.4993,1,0.000000001,0.25\n"
      }
    },
    "schema": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "input"
      ],
      "properties": {
        "input": {
          "type": "object",
          "required": [
            "type",
            "method"
          ],
          "properties": {
            "type": {
              "type": "string",
              "const": "http"
            },
            "method": {
              "enum": [
                "GET"
              ],
              "type": "string"
            },
            "queryParams": {
              "type": "object",
              "properties": {
                "blocks": {
                  "type": "integer",
                  "description": "How many blocks (1..1024, default 300)."
                },
                "format": {
                  "type": "string",
                  "description": "csv (default) or jsonl."
                },
                "newest": {
                  "type": "string",
                  "description": "\"latest\" (default) or a block number — page backwards by passing oldest_block-1 of the previous page."
                }
              }
            }
          },
          "additionalProperties": false
        },
        "output": {
          "type": "object",
          "required": [
            "type"
          ],
          "properties": {
            "type": {
              "type": "string"
            },
            "example": {
              "type": "string",
              "description": "text/csv or application/jsonl; one row per block."
            }
          }
        }
      }
    }
  }
}

Provenance

Seen in the source catalog

2026-07-03 07:40Z

Last indexed by Roundhouse

2026-07-25 00:00Z

Last enriched (probe, favicon, geo)

2026-09-14 06:15Z

x402 version

2

Max timeout

120s

Liveness probe

HTTP 402