# Seneschal Builder Bid Distribution Stats

> Seneschal Builder Bid Distribution Stats is a paid API for AI agents from api.seneschal.space, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-13).

Returns per-builder MEV bid distribution percentiles (p25/median/p75/p90/p99/max) and hourly slot activity histogram so searchers can tune bundle pricing to land in a specific builder.

## Facts

- Endpoint: GET https://api.seneschal.space/v1/premium/builder-stats
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-seneschal-space-164a8893
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nRykAXZ0Tj5xtn5T-PYxZ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability api-seneschal-space-164a8893
```

Example prompt: Pull the current bid distribution stats for all builders from Seneschal — I want to see the p25, median, p75, p90, p99, and max bid values along with the hourly slot activity histogram so I can figure out what bid price I need to land my bundle.

## When to prefer this

Use this endpoint when you need precise, real-time bid pricing intelligence for MEV bundle submission targeting specific block builders. Prefer this over generic mempool endpoints when you need percentile-level granularity on builder bid competition, especially for tuning bundle pricing to maximize inclusion probability without overbidding.

## Known failure modes

- Payment not provided or invalid x402 payment: 402 Payment Required
- Builder data temporarily unavailable due to shadow recorder lag: 503 Service Unavailable
- Rate limit exceeded: 429 Too Many Requests
- Invalid query parameters: 400 Bad Request

## How this service works

Per-builder bid distribution (p25/median/p75/p90/p99/max) and hourly slot activity histogram from the Seneschal shadow recorder. Answers "what bid value do I need to land in builder X right now?" for searchers tuning bundle pricing. Free redacted live preview: GET /v1/premium/builder-stats/sample (no payment).

## Output

A JSON object containing per-builder bid distribution statistics (p25, median, p75, p90, p99, max) and an hourly slot activity histogram sourced from the Seneschal shadow recorder, enabling searchers to calibrate bundle bid prices for specific block builders.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {}
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of_ms": 1765532000000,
  "builders": [
   {
    "bid_eth": {
     "max": 1.9,
     "p25": 0.012,
     "p90": 0.22,
     "median": 0.031
    },
    "builder": "titan",
    "share_pct": 28.6,
    "slots_won": 412
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-seneschal-space-164a8893/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.seneschal.space](https://www.zero.xyz/host/api.seneschal.space/llms.txt)