{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/aspern-org/json-schema/aspern-org-revenue-data-schema.json",
  "title": "RevenueData",
  "description": "Observed, not designed. This shape was derived by calling the operation and recording what came back, and it is re-derived and compared on every deploy. Types are what was seen. Fields listed under `required` are the ones this API commits to returning, declared by hand rather than inferred — everything else is what was observed, and an absent measurement is a real answer here rather than a fault. Required means present, never non-null.",
  "x-generated": "2026-11-01",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/aspern-org-openapi.json#/components/schemas/RevenueData",
  "type": "object",
  "required": [
    "data",
    "meta",
    "warnings"
  ],
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "note": {
          "type": "string"
        },
        "prices": {
          "type": "object",
          "properties": {
            "at": {
              "type": "string"
            },
            "cardsWithEndpoint": {
              "type": "number"
            },
            "endpoints": {
              "type": "number"
            },
            "rootsAsked": {
              "type": "number"
            },
            "rootSample": {
              "type": "number"
            },
            "complete": {
              "type": "boolean"
            },
            "answers": {
              "type": "object",
              "properties": {
                "quoted": {
                  "type": "number"
                },
                "priced-unreadable": {
                  "type": "number"
                },
                "open": {
                  "type": "number"
                },
                "gated": {
                  "type": "number"
                },
                "refusing": {
                  "type": "number"
                },
                "unreachable": {
                  "type": "number"
                }
              }
            },
            "claims": {
              "type": "object",
              "properties": {
                "cardsDeclaringX402": {
                  "type": "number"
                },
                "declaredButDidNotQuote": {
                  "type": "number"
                },
                "quotedWithoutDeclaring": {
                  "type": "number"
                }
              }
            },
            "catalogue": {
              "type": "object",
              "properties": {
                "resources": {
                  "type": "number"
                },
                "sellers": {
                  "type": "number"
                },
                "median": {
                  "type": "number"
                },
                "min": {
                  "type": "number"
                },
                "max": {
                  "type": "number"
                },
                "bands": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "band": {
                        "type": "string"
                      },
                      "count": {
                        "type": "number",
                        "x-unit": "count"
                      }
                    }
                  }
                },
                "note": {
                  "type": "string"
                }
              }
            },
            "probe": {
              "type": "object",
              "properties": {
                "median": {
                  "description": "Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero."
                },
                "min": {
                  "description": "Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero."
                },
                "max": {
                  "description": "Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero."
                },
                "pricedInUnknownAsset": {
                  "type": "number"
                },
                "measured": {
                  "type": "number",
                  "x-unit": "count"
                }
              }
            },
            "quotes": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string"
                  },
                  "registrations": {
                    "type": "number",
                    "x-unit": "count"
                  },
                  "usd": {
                    "description": "Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero. Observed only as null so far; the type it carries when present has not been recorded. Null means unavailable or not measured, never zero."
                  },
                  "amount": {
                    "type": "string"
                  },
                  "asset": {
                    "type": "string"
                  },
                  "network": {
                    "type": "string"
                  }
                }
              }
            },
            "agreement": {
              "type": "object",
              "properties": {
                "asked": {
                  "type": "number"
                },
                "same": {
                  "type": "number"
                },
                "different": {
                  "type": "number"
                },
                "noLongerPriced": {
                  "type": "number"
                },
                "unreachable": {
                  "type": "number"
                }
              }
            },
            "movement": {
              "type": "object",
              "properties": {
                "added": {
                  "type": "number"
                },
                "changed": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "url": {
                        "type": "string"
                      },
                      "from": {
                        "type": "string"
                      },
                      "to": {
                        "type": "string"
                      }
                    }
                  }
                },
                "withdrawn": {
                  "type": "number"
                },
                "comparable": {
                  "type": "boolean"
                }
              }
            },
            "method": {
              "type": "string"
            },
            "caveat": {
              "type": "string"
            }
          }
        },
        "treasury": {
          "type": "object",
          "properties": {
            "at": {
              "type": "string"
            },
            "earners": {
              "type": "number"
            },
            "pricedEarners": {
              "type": "number"
            },
            "pricedEarnedUsd": {
              "type": "number",
              "x-unit": "usd"
            },
            "outcomes": {
              "type": "object",
              "properties": {
                "spentOnARailAfterEarning": {
                  "type": "number"
                },
                "lentIntoAVaultWeRead": {
                  "type": "number"
                },
                "holdingABalanceWeCanRead": {
                  "type": "number"
                },
                "tradingOnAVenueWeRead": {
                  "type": "number"
                },
                "noneOfThoseVisible": {
                  "type": "number"
                }
              }
            },
            "spentOnlyBeforeEarning": {
              "type": "number"
            },
            "heldUsd": {
              "type": "number",
              "x-unit": "usd"
            },
            "balanceCoverage": {
              "type": "object",
              "properties": {
                "addressesRead": {
                  "type": "number",
                  "x-unit": "count"
                },
                "earnersAmongThem": {
                  "type": "number"
                },
                "paidInKnown": {
                  "type": "number"
                },
                "balancesAsked": {
                  "type": "number"
                },
                "stillHolding": {
                  "type": "number"
                },
                "chainsUnread": {
                  "type": "number"
                },
                "byChainAsked": {
                  "type": "object",
                  "properties": {
                    "polygon": {
                      "type": "number"
                    },
                    "base": {
                      "type": "number",
                      "x-unit": "index-level"
                    },
                    "ethereum": {
                      "type": "number"
                    },
                    "arbitrum": {
                      "type": "number"
                    },
                    "optimism": {
                      "type": "number"
                    }
                  }
                }
              }
            },
            "tradedBy": {
              "type": "object",
              "properties": {
                "capital.gmxAccounts": {
                  "type": "number"
                },
                "capital.ostium": {
                  "type": "number"
                },
                "commerce.polymarket": {
                  "type": "number"
                }
              }
            },
            "largestUnexplained": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "address": {
                    "type": "string"
                  },
                  "usd": {
                    "type": "number",
                    "x-unit": "usd"
                  },
                  "events": {
                    "type": "number",
                    "x-unit": "count"
                  }
                }
              }
            },
            "reach": {
              "type": "number"
            },
            "method": {
              "type": "string"
            },
            "caveat": {
              "type": "string"
            }
          }
        },
        "asOf": {
          "type": "string"
        },
        "pricesAsOf": {
          "type": "string"
        },
        "treasuryAsOf": {
          "type": "string"
        }
      }
    },
    "meta": {
      "$ref": "#/$defs/Meta"
    },
    "warnings": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Warning"
      }
    }
  },
  "$defs": {
    "Meta": {
      "type": "object",
      "required": [
        "requestId",
        "snapshotId",
        "servedAt",
        "methodologyVersion",
        "coverage"
      ],
      "properties": {
        "requestId": {
          "type": "string",
          "description": "Also the X-Request-Id header."
        },
        "environment": {
          "type": "string",
          "description": "production, staging or development. Also the X-ASPERN-Environment header and info.x-aspern-environment in the OpenAPI document, so a client can tell which contract answered."
        },
        "build": {
          "type": [
            "string",
            "null"
          ],
          "description": "The deploy that served this. Also the X-ASPERN-Build header."
        },
        "snapshotId": {
          "type": "string",
          "description": "Which state of our data answered. Two responses with the same snapshotId saw the same completed ingest runs — so a figure that differs between two surfaces under the SAME snapshot is a defect, and under different ones is a clock."
        },
        "observedAt": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time",
          "description": "When the source was observed."
        },
        "computedAt": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time",
          "description": "When we computed this from it."
        },
        "servedAt": {
          "type": "string",
          "format": "date-time",
          "description": "When this response was built."
        },
        "methodologyVersion": {
          "type": "string",
          "description": "What the figures mean. Changes are listed at /changelog."
        },
        "source": {
          "type": [
            "string",
            "null"
          ]
        },
        "chainId": {
          "type": [
            "integer",
            "null"
          ],
          "x-unit": "chain-id"
        },
        "blockNumber": {
          "type": [
            "integer",
            "null"
          ],
          "x-unit": "block-number"
        },
        "coverage": {
          "type": "object",
          "properties": {
            "scope": {
              "type": [
                "string",
                "null"
              ],
              "description": "What this covers and, explicitly, what it does not."
            },
            "population": {
              "type": [
                "string",
                "null"
              ],
              "description": "The population these figures were measured over, as a key you can join on rather than a sentence you have to read. Every key is declared once and resolves to a definition at /reconciliation#<key>, where the ones that narrow show every row that falls out and why. The same key appears beside the figure on the website, so an integrator and a reader are talking about one population rather than two descriptions of it. Null only when `populationAbsence` says why."
            },
            "populationAbsence": {
              "type": [
                "string",
                "null"
              ],
              "description": "Why there is no single population, where there is none. A lookup of one address measures nothing; a document carrying several rails in units that are never summed carries several populations. A null population with nothing here would be an absence you could not tell from an oversight, which is the defect this field exists to close."
            },
            "knownExclusions": {
              "type": [
                "array",
                "null"
              ],
              "items": {
                "type": "string"
              },
              "description": "THREE VALUES. A list is what this route deliberately leaves out. `[]` is a CLAIM that nothing is excluded. `null` is “we have not said”, which is our gap and must never be read as the second. It was hardcoded to `[]` on every route until 2026-09-27, so every response claimed to exclude nothing while its own `scope` sentence named exclusions."
            }
          }
        },
        "confidence": {
          "type": [
            "object",
            "null"
          ],
          "description": "Never a bare number; it names what it is a confidence in."
        },
        "freshness": {
          "anyOf": [
            {
              "type": "object",
              "required": [
                "oldestObservedAt",
                "newestObservedAt",
                "readings",
                "fields",
                "complete",
                "state",
                "newestAgeHours"
              ],
              "description": "When the readings behind this answer were taken, where they differ. A page of a hundred vaults read over four hours has no single observation time — `observedAt` is filled in only where every reading agrees, and this reports the spread otherwise.",
              "properties": {
                "oldestObservedAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "newestObservedAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "readings": {
                  "type": "integer",
                  "minimum": 1,
                  "description": "How many readings the range was taken over.",
                  "x-unit": "count"
                },
                "fields": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "The fields it was read from, so a caller can go and check any of them directly."
                },
                "complete": {
                  "type": "boolean",
                  "description": "Whether every reading in the payload was seen. False means the range is a LOWER BOUND — the true spread is at least this wide and may be wider — because a partial walk always returns the narrower range, which would read as fresher and more uniform than the data is."
                },
                "state": {
                  "enum": [
                    "fresh",
                    "mixed",
                    "stale"
                  ],
                  "description": "`stale` when the NEWEST reading is more than 26 hours old at the moment the response was built — every reader runs at least daily, so that means a reader has stopped. `mixed` when the newest is inside that window and the OLDEST is not: parts of this answer are current and parts are not, which is the usual shape of a document joining several sources. It was summarised as `fresh` until 2026-10-10, computed from the newest reading alone, so one current field hid a catalogue two months old. A source that could not be read is not a state here: it is a check that could not run (`/v1/checks`) or an analysis whose `availability` says so, and never a zero."
                },
                "newestAgeHours": {
                  "type": "number",
                  "minimum": 0,
                  "description": "Hours between the newest reading and the moment this response was built, to one decimal.",
                  "x-unit": "hours"
                },
                "oldestAgeHours": {
                  "type": "number",
                  "minimum": 0,
                  "description": "The same for the OLDEST reading. The other end of the spread as a number, because a caller comparing two ISO strings to find out whether part of an answer is two months old will mostly not bother.",
                  "x-unit": "hours"
                }
              }
            },
            {
              "type": "object",
              "required": [
                "reason",
                "state",
                "says",
                "readings"
              ],
              "description": "No range, and which of the two reasons it is.",
              "properties": {
                "reason": {
                  "enum": [
                    "not-applicable",
                    "no-dated-field"
                  ],
                  "description": "`not-applicable` is reference material: a plan, a capability list, a schema. Nothing in it was read from anywhere at a time. `no-dated-field` means the response carries data and nothing in it names when that data was read, which is a gap in that endpoint."
                },
                "state": {
                  "enum": [
                    "not_applicable",
                    "not_measured"
                  ],
                  "description": "The reason in the vocabulary shared with `fresh`/`stale`: `not-applicable` is `not_applicable`, `no-dated-field` is `not_measured`."
                },
                "says": {
                  "type": "string",
                  "description": "The same thing in a sentence."
                },
                "readings": {
                  "const": 0
                }
              }
            }
          ]
        },
        "pagination": {
          "anyOf": [
            {
              "$ref": "#/$defs/Page"
            },
            {
              "type": "null"
            }
          ]
        }
      }
    },
    "Page": {
      "type": "object",
      "required": [
        "total",
        "limit",
        "offset",
        "hasMore"
      ],
      "properties": {
        "total": {
          "type": "integer",
          "minimum": 0,
          "description": "Rows matching the filter, not rows returned.",
          "x-unit": "count"
        },
        "limit": {
          "type": "integer",
          "minimum": 0,
          "description": "Applied page size. May be below what was asked — X-Page-Limit says so when it is.",
          "x-unit": "count"
        },
        "offset": {
          "type": "integer",
          "minimum": 0,
          "x-unit": "count"
        },
        "hasMore": {
          "type": "boolean"
        },
        "nextOffset": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Null on the last page.",
          "x-unit": "count"
        },
        "orderedBy": {
          "type": "string",
          "description": "The sort, including its tie-breaker. The order is total, so paging cannot show a row twice or skip one."
        }
      }
    },
    "Warning": {
      "type": "object",
      "required": [
        "code",
        "message"
      ],
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        }
      }
    }
  }
}