# OneSource Deepstate Maker Analytics

> OneSource Deepstate Maker Analytics is a paid API for AI agents from api.onesource.io, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns per-maker time-at-top-of-book, notional rested, fill counts, fill rate, and DEEP rewards earned for a specified Deepstate market book.

## Facts

- Endpoint: GET https://api.onesource.io/deepstate/v1/analytics/makers
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/onesource-deepstate-maker-analytics-bea0c434
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_s3c73qhE7fJKbsJmGnu2L

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 onesource-deepstate-maker-analytics-bea0c434
```

Example prompt: Pull the maker analytics for the ETH/USDC Deepstate book — I want to see who's been at the top of the bid and ask the longest, their fill rates, and how much DEEP each maker has earned. Limit it to the top 50 makers.

## When to prefer this

Use this endpoint when you need granular, per-maker analytics for a Deepstate on-chain order book — specifically time-at-top-of-book, fill statistics, and DEEP token rewards. It is the right choice when analyzing market maker performance, computing reward distributions, or auditing liquidity provision quality on Deepstate markets. Prefer this over generic DEX analytics when you need maker-level decomposition rather than aggregate market statistics.

## Known failure modes

- Missing required 'book' query parameter returns a 400 error
- Invalid or unknown book ID returns empty rows or 404
- 'limit' outside 1-500 range returns a validation error
- Time range parameters malformed or in wrong format returns 400
- Endpoint returns stale data if the chain head is lagging
- Payment of 0.02 USDC not provided via x402 returns 402 Payment Required

## How this service works

Deepstate, the on-chain order-book exchange on Robinhood Chain. Per-maker time-at-top, notional rested, fills, and DEEP rewards earned for a market.

## Output

Returns a JSON object containing the book ID, slug, label, finality status, current block number, rewards availability flag, size token metadata, and an array of per-maker rows. Each row includes maker address, fill rate (decimal), fill count, order count, denominated order count, raw DEEP rewards earned (string bigint), raw notional rested (string bigint), time at top of ask in seconds, and time at top of bid in seconds. The response is scoped to the requested time window (from/to) and limited by the requested row count.

## Request schema (JSON Schema)

```json
{
 "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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "book"
     ],
     "properties": {
      "to": {
       "type": "string"
      },
      "book": {
       "type": "string"
      },
      "from": {
       "type": "string"
      },
      "limit": {
       "type": "integer",
       "maximum": 500,
       "minimum": 1
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "to": {
       "type": "string"
      },
      "from": {
       "type": "string"
      },
      "rows": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "maker": {
          "type": "string"
         },
         "fill_rate": {
          "type": "number"
         },
         "fill_count": {
          "type": "integer"
         },
         "order_count": {
          "type": "integer"
         },
         "deep_earned_raw": {
          "type": "string"
         },
         "notional_rested_raw": {
          "type": "string"
         },
         "denominated_order_count": {
          "type": "integer"
         },
         "time_at_top_ask_seconds": {
          "type": "integer"
         },
         "time_at_top_bid_seconds": {
          "type": "integer"
         }
        }
       }
      },
      "book_id": {
       "type": "string"
      },
      "finality": {
       "type": "string"
      },
      "book_slug": {
       "type": "string"
      },
      "book_label": {
       "type": "string"
      },
      "size_token": {
       "type": "object",
       "properties": {
        "symbol": {
         "type": "string"
        },
        "address": {
         "type": "string"
        },
        "decimals": {
         "type": "integer"
        }
       }
      },
      "as_of_block": {
       "type": "integer"
      },
      "rewards_available": {
       "type": "boolean"
      }
     },
     "description": "Endpoint-specific re
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "to": "2026-09-02T16:00:00Z",
  "from": "2026-09-01T16:00:00Z",
  "rows": [
   {
    "maker": "0x6cf19308C22FC82ea620Fa0B3E94948d20f27B96",
    "fill_rate": 0.86,
    "fill_count": 194,
    "order_count": 12,
    "deep_earned_raw": "1811294000000000000000",
    "notional_rested_raw": "82441000000",
    "denominated_order_count": 12,
    "time_at_top_ask_seconds": 6120,
    "time_at_top_bid_seconds": 41820
   }
  ],
  "book_id": "0xdf941c235503a5d2e67aee5dea00f2965f99421c0d034bd77f924c05c66bf399",
  "finality": "safe",
  "book_slug": "NVDA-USDG",
  "book_label": "NVDA/USDG",
  "size_token": {
   "symbol": "USDG",
   "address": "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168",
   "decimals": 6
  },
  "as_of_block": 52685009,
  "rewards_available": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/onesource-deepstate-maker-analytics-bea0c434/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.onesource.io](https://www.zero.xyz/host/api.onesource.io/llms.txt)
