{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/aspern-org/json-schema/aspern-org-rwa-data-schema.json",
  "title": "RwaData",
  "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/RwaData",
  "type": "object",
  "required": [
    "data",
    "meta",
    "warnings"
  ],
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "at": {
          "type": "string",
          "format": "date-time"
        },
        "classes": {
          "type": "object",
          "description": "NEVER SUM THESE. A named instrument, a stablecoin reserve and a synthetic position are three different claims at three different sizes. `measured: false` means the class is not readable at all, which is not zero.",
          "properties": {
            "tokenised": {
              "type": "object",
              "properties": {
                "usd": {
                  "type": "number",
                  "x-unit": "usd"
                },
                "vaults": {
                  "type": "number",
                  "x-unit": "count"
                },
                "measured": {
                  "type": "boolean"
                },
                "byBasis": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "basis": {
                        "type": "string"
                      },
                      "usd": {
                        "type": "number",
                        "x-unit": "usd"
                      },
                      "vaults": {
                        "type": "number",
                        "x-unit": "count"
                      }
                    }
                  }
                }
              }
            },
            "reserve": {
              "type": "object",
              "properties": {
                "usd": {
                  "type": "number",
                  "x-unit": "usd"
                },
                "vaults": {
                  "type": "number",
                  "x-unit": "count"
                },
                "measured": {
                  "type": "boolean"
                },
                "byIssuer": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "issuer": {
                        "type": "string"
                      },
                      "usd": {
                        "type": "number",
                        "x-unit": "usd"
                      },
                      "vaults": {
                        "type": "number",
                        "x-unit": "count"
                      },
                      "symbols": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "products": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "symbol": {
                              "type": "string"
                            },
                            "usd": {
                              "type": "number",
                              "x-unit": "usd"
                            },
                            "vaults": {
                              "type": "number",
                              "x-unit": "count"
                            },
                            "reserveBasis": {
                              "type": "string"
                            },
                            "currency": {
                              "type": [
                                "null",
                                "string"
                              ]
                            },
                            "reserveSource": {
                              "type": [
                                "null",
                                "string"
                              ]
                            }
                          }
                        }
                      },
                      "reserveBasis": {
                        "type": "string"
                      },
                      "attestor": {
                        "type": [
                          "null",
                          "string"
                        ]
                      },
                      "cadence": {
                        "type": [
                          "null",
                          "string"
                        ]
                      },
                      "lastReportDate": {
                        "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."
                      }
                    }
                  }
                }
              }
            },
            "synthetic": {
              "type": "object",
              "properties": {
                "usd": {
                  "type": "number",
                  "x-unit": "usd"
                },
                "vaults": {
                  "type": "number",
                  "x-unit": "count"
                },
                "venues": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string"
                      },
                      "usd": {
                        "type": "number",
                        "x-unit": "usd"
                      },
                      "at": {
                        "type": "string"
                      }
                    }
                  }
                },
                "measured": {
                  "type": "boolean"
                },
                "basis": {
                  "type": "string"
                },
                "attributed": {
                  "type": "boolean"
                }
              }
            },
            "collateral": {
              "type": "object",
              "properties": {
                "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."
                },
                "vaults": {
                  "type": "number",
                  "x-unit": "count"
                },
                "measured": {
                  "type": "boolean"
                }
              }
            },
            "offchain": {
              "type": "object",
              "properties": {
                "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."
                },
                "vaults": {
                  "type": "number",
                  "x-unit": "count"
                },
                "measured": {
                  "type": "boolean"
                }
              }
            }
          }
        },
        "agentTokenisedUsd": {
          "type": "number",
          "description": "Of the named instruments, how much sits in software-managed vaults.",
          "x-unit": "usd"
        },
        "crypto": {
          "type": "object",
          "properties": {
            "usd": {
              "type": "number",
              "x-unit": "usd"
            },
            "vaults": {
              "type": [
                "integer",
                "number"
              ],
              "x-unit": "count"
            },
            "why": {
              "type": "string"
            }
          }
        },
        "unclassified": {
          "type": "object",
          "properties": {
            "usd": {
              "type": "number",
              "x-unit": "usd"
            },
            "vaults": {
              "type": [
                "integer",
                "number"
              ],
              "x-unit": "count"
            },
            "why": {
              "type": "string"
            },
            "symbols": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "symbol": {
                    "type": "string"
                  },
                  "usd": {
                    "type": "number",
                    "x-unit": "usd"
                  },
                  "vaults": {
                    "type": "number",
                    "x-unit": "count"
                  }
                }
              }
            }
          }
        },
        "noUnderlying": {
          "type": "object",
          "properties": {
            "usd": {
              "type": "number",
              "x-unit": "usd"
            },
            "vaults": {
              "type": [
                "integer",
                "number"
              ],
              "x-unit": "count"
            },
            "why": {
              "type": "string"
            }
          }
        },
        "holdings": {
          "type": "array",
          "description": "Absent without a plan; `withheld` names what was removed.",
          "items": {
            "type": "object",
            "properties": {
              "slug": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "platformSlug": {
                "type": "string"
              },
              "platformName": {
                "type": "string"
              },
              "symbol": {
                "type": "string"
              },
              "chain": {
                "type": "string"
              },
              "address": {
                "type": "string"
              },
              "issuer": {
                "type": [
                  "null",
                  "string"
                ]
              },
              "represents": {
                "type": "string"
              },
              "basis": {
                "type": "string"
              },
              "usd": {
                "type": "number",
                "x-unit": "usd"
              },
              "agentManaged": {
                "type": "boolean"
              },
              "operator": {
                "type": "string"
              },
              "operatorMode": {
                "type": "string"
              },
              "operatorModeConfidence": {
                "type": "number",
                "x-unit": "decimal-fraction"
              }
            }
          }
        },
        "withheld": {
          "type": "string"
        },
        "operatorAutomatedTokenisedUsd": {
          "type": "number",
          "x-unit": "usd"
        },
        "operatorAutomatedVaults": {
          "type": "number",
          "x-unit": "count"
        },
        "instruments": {
          "type": "number",
          "x-unit": "count"
        }
      }
    },
    "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"
        }
      }
    }
  }
}