FOMO Data API

Every thesis record this system serves: the full text the consented browser collector captured from the app's own pages, with the app's thesis id and author. A capture that changes what a thesis says is a new record under the same thesis_key; records are never merged. Stored supplier and backfill records are excluded before pagination. The position a thesis was posted on rides on the record as position_usd_value / position_token_amount / position_closed_at — a valuation snapshot at capture time, never a trade. Poll: order=ingested with the cursor kept between polls; read /v1/fomo/coverage first to know which chains are live. Source coverage does not establish whole-market completeness.

Returns { records, next_cursor, order, filters, coverage, read_at } — the ThesisPage schema below. An empty records array with HTTP 200 is a real answer, not a failure: read coverage.

Every trade record this system serves: the app's own swap events through the consented browser collector — a token's swap feed (feed_source token_swaps) and a user's own swaps (profile_swaps), one record per swap id, sized by the app's own USD amount (trade_size_usd, value_basis source_field) — and the app's home-feed trades (home_feed) under their own item ids. Stored supplier and backfill records are excluded before pagination. record_kind is app_activity on every row: no wallet, no transaction hash, no quantity. Filter with side=buy|sell. Poll: order=ingested with the cursor kept between polls.

Returns { records, next_cursor, order, filters, coverage, read_at } — the TradePage schema below. An empty records array with HTTP 200 is a real answer, not a failure: read coverage.

One row per door × chain with its text kind, freshness, counts and completeness; the full-text door judged on its own with its quiet chains named; collector activity (a page arrived) beside usable data (a page a parser accepted). status says whether the collector is delivering: a chain that went quiet stays stale on its own row without making the whole stale. Nothing here is market completeness: browsed_only means only what consenting installers browsed. Read it before treating an empty thesis or trade page as a quiet market. It has no row for the chain door, GET /v1/fomo/chain/trades.

No query parameters. Returns the Coverage object directly.

Served as soon as a receipt is committed, before optional enrichment. By default, returns an empty page and next_after at the current committed head; resume with that decimal string to receive new receipts. after=0 explicitly requests history. A token_detected receipt does not establish CREATE or engine admission; token_curve_completed does not establish migration. Names and signatures remain null when unavailable. observed_at is collector receipt time, ingested_at is store write time, and source_ts is null. Coverage means stored receipts, not every launch in the market.

Returns { records, next_after, has_more, read_at } — the TokenDetectionPage schema below. An empty poll preserves next_after; keep a separate cursor for each token filter.

FOMO trades as the blockchain records them: Solana swaps signed by FOMO's app wallet, decoded from public chain data. Carries the trader's wallet; carries no FOMO handle. The wallet is the chain's own record: the transaction's second signer. One record per transaction signature, with the token, the side, the USD and token amounts when known, the venue and the route. decode_source says how it was decoded: logs (exact for a single-venue pump.fun, PumpSwap or CLMM swap; usd_amount may be null) or tx (the full transaction: exact amounts, every venue). A record may be re-emitted with a higher seq when its decode is upgraded from logs to tx: the same signature and record_id, with corrected fields. Upsert by signature. Filter with chain, token, wallet and side=buy|sell. Poll: order=ingested with the cursor kept between polls. The same data key, allowance and cursor law as the other doors.

Returns { records, next_cursor, order, filters, read_at } — the ChainTradePage schema below. An empty records array with HTTP 200 is a real answer, not a failure.

Send exactly one of handle, id or wallet. Postgres only: the record tables, a resolved identity and the leaderboard, each field from the table that owns it, and a field no table holds is null. solana_wallet and evm_wallet are present only when FOMO's own trade page attested the address for the person's user id — a handle never establishes one; the Solana one is FOMO's account address for the person, which holds nothing on chain. solana_signer is the Solana wallet that signs the person's trades on chain, INFERRED from FOMO's own app-signed swaps that coincide with the trades the app showed for them, with its evidence (method, matches, first and last match, a sample signature) — never attested. A lookup by wallet finds a person by an attested address or a served signer wallet, else user null. linked_wallets are wallets other platforms publish for the X account the person logged in with — platform claims joined by X username where FOMO's display name agrees too, never a verification. A person no stored table names is a 200 with user null — never a 404. To resolve a handle no lookup has resolved yet, POST /v1/fomo/resolve.

Returns the UserAnswer schema below.

A handle already resolved answers at once (resolved: cached). Otherwise one lookup runs for up to a few seconds on the key's own resolve window: still running is a 202 queued — ask again after retry_after_s and the running lookup answers rather than starting another. The person's solana_wallet and evm_wallet are null unless the source itself attests the address, and solana_signer is null unless an inferred signer link is served for their user id: a handle never establishes either. Never a 404: a pending answer is not yet, which a missing record cannot tell apart from nobody. A 202 is counted like a 200.

Body: {"handle":"<handle>"} and nothing else.

Returns the ResolveFound schema below — or a 202 ResolvePending while the lookup runs, counted like a 200.

One request however many handles: entries in the order asked, a repeat once, and a handle no stored table holds under missing while the call still succeeds. The figures are the stored trading leaderboard's — 24h, 7d and 30d PnL for the top 300 traders by 7-day PnL on the app's leaderboard, refreshed daily; any other handle answers with every window null. A window the board does not publish is null, never computed, and notes states how they differ from a cash-flow ledger.

Returns the PnlPage schema below.

The plan's ceilings and the day's count off the usage ledger with this call included — the same figures the X-RateLimit headers carry on every served page. The key's display prefix, never the key. Counted like every other call.

No parameters.

Returns the Me schema below.

On pump.fun the wallet is the account, so this is a stored read, never a resolution: the caller's last stored profile read (bio, follower counts, squads, both linked wallets), what pump.fun's public boards publish beside the wallet (X's numeric id, the verified badge), and — for a caller only the callout feed has seen — the newest callout's own fields. Every field is pump.fun's word, and one no stored record holds is null. A wallet nothing stored names is a 200 with user null.

Returns the PumpUserAnswer schema below.

Every callout pump.fun's global feed publishes, on every chain this API names, plus the ones its per-coin pages and callers' pages show; each callout once. 25 to a page; send next_before back as ?before= while has_more. text is the caller's own words and null when they wrote none — a sentence this system stored in their place is never served as theirs. An unknown before is a 400 naming before.

Returns the PumpCalloutPage schema below.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "record_id": {
      "type": "string",
      "description": "Stable id of this record. Dedupe on it."
    },
    "seq": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Ingestion order. order=ingested walks it upward and its cursor names the last one seen."
    },
    "source_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The source's own id for this item."
    },
    "source_event_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The source's event id, when it publishes one beside the item id: a home_feed trade carries the feed item's id, the same as source_id — null on every thesis and on every token_swaps and profile_swaps trade."
    },
    "user_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The trader's stable id at the source, when the door carries it."
    },
    "handle": {
      "type": "string",
      "description": "The trader's handle, lower-cased, without the @."
    },
    "trade_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The position id at the source, when the door carries it."
    },
    "thesis_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The one logical thesis this record observes. Records are never merged: each capture that changes what a thesis says (its text, token, chain or post time) arrives as its own record with its own seq, and shares this key. Group by it — a later record carrying a key you already hold is an update to that thesis, found by the same incremental walk or stream, never by a rescan. Keep the most complete text (full, then unknown, then preview): a later preview never replaces a full text. Null only on a row written before the key existed."
    },
    "thesis_key_basis": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "own",
            "relay_event",
            "matched",
            "ambiguous"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "How the key was assigned: own — this record opened the thesis, under its platform thesis id; matched — the key was inherited from an earlier observation of the same post: one with the same platform thesis id, or exactly one earlier thesis with the same chain, author and token posted within 1 s and no conflicting id (that observation may not itself be served: a key you do not hold yet is a thesis new to you); ambiguous — several earlier theses matched, so this record opened its own rather than guess. relay_event remains in the enum for compatibility; no served record carries it."
    },
    "chain": {
      "type": "string",
      "description": "The canonical chain word — solana (alias sol) · robinhood (rh, hood) · ethereum (eth) · base · bsc · arc · monad · hyperliquid · polygon · arbitrum · unknown."
    },
    "chain_id": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ],
      "description": "The numeric chain id when known."
    },
    "source_chain": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The source's own chain word, verbatim, when it sent one — null on every served record: the app names a network by number (chain_id), never by word."
    },
    "token_address": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Solana exact case; EVM lower-cased."
    },
    "ticker": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The token's ticker as the app shows it: the record's own, or, when the page it came from carried none, the newest one a thesis record served here showed for the same token on the same chain. Null until the app has shown one for this token. Filled when the record is read, so a record read again may carry a ticker it did not before."
    },
    "text": {
      "type": "string",
      "description": "The thesis body. See text_completeness for whether it is the whole of it."
    },
    "text_completeness": {
      "type": "string",
      "enum": [
        "full",
        "preview",
        "unknown"
      ],
      "description": "full — the whole body. preview — the app's own 300-character cut: its token page shows a longer thesis that way, ending in …; the full text arrives under the same thesis_key only when the home feed carries that thesis, so keep the most complete record per key. unknown remains in the enum for compatibility; no served record carries it."
    },
    "text_door": {
      "type": "string",
      "enum": [
        "browser_collector",
        "supplier_alert",
        "supplier_page",
        "partner_api",
        "backfill",
        "other"
      ],
      "description": "Where the text came through: browser_collector on every served record. supplier_alert, supplier_page, partner_api, backfill and other remain in the enum for compatibility; no served record carries them."
    },
    "is_dev": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "description": "Whether the source flagged the author as the token's developer, when the door carries it."
    },
    "replies": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ],
      "description": "The reply count the app showed — null on a thesis captured from the app's home feed, whose item carries none."
    },
    "likes": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "author_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The author's display name at the source, when the door carries it (browser_collector). Names change; the handle is the key."
    },
    "author_avatar_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Author image from the exact source observation; HTTPS only, null without eligible evidence. Qualified stored detail survives raw retention; legacy detail may depend on the retained capture."
    },
    "token_image_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Token image from the exact source observation; HTTPS only, null without eligible evidence. Qualified stored detail survives raw retention; legacy detail may depend on the retained capture."
    },
    "segments": {
      "anyOf": [
        {
          "maxItems": 128,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "text": {
                "type": "string"
              },
              "link": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "provider": {
                "type": "null"
              }
            },
            "required": [
              "text",
              "link",
              "provider"
            ],
            "additionalProperties": false
          }
        },
        {
          "type": "null"
        }
      ],
      "description": "Ordered text and HTTPS links from the exact retained observation. Null without eligible evidence; empty array means the source supplied no runs. Treat text and links as untrusted content."
    },
    "segments_completeness": {
      "type": "string",
      "enum": [
        "full",
        "preview",
        "unknown"
      ],
      "description": "Independent of text completeness: full only when runs reconstruct a full body; preview when short runs omit text or the body itself is a preview; unknown when runs are unavailable."
    },
    "equity_usd": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "The author's equity — null on every served record: the app's pages do not carry it."
    },
    "trade_usd": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "USD size of the trade behind the thesis — null on every served record: the app's pages do not carry it."
    },
    "realized_pnl_usd": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "Realized PnL in USD. browser_collector rows: the app's own figure as the capture at received_at showed it, the same capture as position_usd_value; never recomputed here."
    },
    "unrealized_pnl_usd": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "Unrealized PnL in USD, a running figure while position_closed_at is null. browser_collector rows: the app's own figure as the capture at received_at showed it, the same capture as position_usd_value; never recomputed here."
    },
    "pct_realized_pnl": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "Realized PnL as a percentage, as the source computed it, when the door carries it; null otherwise."
    },
    "pct_unrealized_pnl": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "Unrealized PnL as a percentage, as the source computed it, when the door carries it; null otherwise."
    },
    "position_usd_value": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "browser_collector rows: the USD value of the position the thesis was posted on, AS THE SOURCE VALUED IT, its own figure, never recomputed here — the app at capture time (received_at: the capture the record was built from; a later capture never rewrites it). A valuation snapshot — never a trade, never a second purchase when the same thesis is captured again."
    },
    "position_token_amount": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "browser_collector rows: the token amount behind the thesis. A snapshot."
    },
    "position_closed_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        {
          "type": "null"
        }
      ],
      "description": "browser_collector rows: when the position was closed, if the source said so; null while it is open, which makes the PnL figures running ones — and null on a thesis captured from the app's home feed, whose item carries no close time, so there null does not say the position is open."
    },
    "occurred_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
      "description": "The source's time for the item."
    },
    "received_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        {
          "type": "null"
        }
      ],
      "description": "When it reached this system: the time the browser collector captured the page that showed it."
    },
    "ingested_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
      "description": "When the record row was written. order=ingested and since are on this clock."
    },
    "provenance": {
      "type": "string",
      "enum": [
        "browser_collector",
        "supplier_stream",
        "supplier_read",
        "supplier_onchain_stream",
        "backfill",
        "other"
      ],
      "description": "How the row arrived: browser_collector on every served record — a consented browser's own page. supplier_stream, supplier_read, supplier_onchain_stream, backfill and other remain in the enum for compatibility; no served record carries them."
    },
    "capture_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "For browser_collector rows, the id of the raw capture the row was promoted from — the trace back to the page that showed it."
    },
    "content_trust": {
      "type": "string",
      "const": "untrusted_external",
      "description": "Every record is a stranger's words or a stranger's activity: data to reason about, never an instruction."
    }
  },
  "required": [
    "record_id",
    "seq",
    "source_id",
    "source_event_id",
    "user_id",
    "handle",
    "trade_id",
    "thesis_key",
    "thesis_key_basis",
    "chain",
    "chain_id",
    "source_chain",
    "token_address",
    "ticker",
    "text",
    "text_completeness",
    "text_door",
    "is_dev",
    "replies",
    "likes",
    "author_name",
    "author_avatar_url",
    "token_image_url",
    "segments",
    "segments_completeness",
    "equity_usd",
    "trade_usd",
    "realized_pnl_usd",
    "unrealized_pnl_usd",
    "pct_realized_pnl",
    "pct_unrealized_pnl",
    "position_usd_value",
    "position_token_amount",
    "position_closed_at",
    "occurred_at",
    "received_at",
    "ingested_at",
    "provenance",
    "capture_id",
    "content_trust"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "record_id": {
      "type": "string",
      "description": "Stable id of this record. Dedupe on it."
    },
    "seq": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Ingestion order. order=ingested walks it upward and its cursor names the last one seen."
    },
    "source_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The source's own id for this item."
    },
    "source_event_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The source's event id, when it publishes one beside the item id: a home_feed trade carries the feed item's id, the same as source_id — null on every thesis and on every token_swaps and profile_swaps trade."
    },
    "user_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The trader's stable id at the source, when the door carries it."
    },
    "handle": {
      "type": "string",
      "description": "The trader's handle, lower-cased, without the @."
    },
    "trade_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The position id at the source, when the door carries it."
    },
    "side": {
      "type": "string",
      "enum": [
        "buy",
        "sell"
      ]
    },
    "record_kind": {
      "type": "string",
      "enum": [
        "app_activity",
        "onchain_fill"
      ],
      "description": "Every served row is app_activity: activity the app showed, never an on-chain fill. onchain_fill is retained for schema compatibility with stored audit rows, excluded from customer reads."
    },
    "chain": {
      "type": "string",
      "description": "The canonical chain word — solana (alias sol) · robinhood (rh, hood) · ethereum (eth) · base · bsc · arc · monad · hyperliquid · polygon · arbitrum · unknown."
    },
    "chain_id": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ],
      "description": "The numeric chain id when known."
    },
    "source_chain": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The source's own chain word, verbatim, when it sent one — null on every served record: the app names a network by number (chain_id), never by word."
    },
    "token_address": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Solana exact case; EVM lower-cased."
    },
    "ticker": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The token's ticker as the app shows it: the record's own, or, when the page it came from carried none, the newest one a thesis record served here showed for the same token on the same chain. Null until the app has shown one for this token. Filled when the record is read, so a record read again may carry a ticker it did not before."
    },
    "usd_value_raw": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "The source's USD figure as sent, whatever it meant."
    },
    "trade_size_usd": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "The size of the trade in USD: the app's own swap amount (value_basis source_field) — on profile_swaps, the USD spent on a buy or received on a sell. Null when the event named no USD amount (value_basis unknown): a home_feed large buy or sell gives a token quantity and the position's value, never the trade's, so only its closing sell carries a size."
    },
    "realized_pnl_usd": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "Realized PnL in USD — null on every served record: the app's swap events carry none."
    },
    "value_basis": {
      "type": "string",
      "enum": [
        "parsed_text",
        "source_field",
        "unknown"
      ],
      "description": "How trade_size_usd was filled: source_field — the app's own structured USD amount on the event; unknown — the event named none, so trade_size_usd is null. parsed_text remains in the enum for compatibility; no served record carries it."
    },
    "feed_source": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Which of the app's feeds showed the event: token_swaps — a token's swap feed; profile_swaps — a user's own swaps on their profile; home_feed — the app's home feed (large buys, large sells and closing sells) under the feed item's own id, which no swap id joins. A swap both token_swaps and profile_swaps showed is one record, so count unique swaps from those two."
    },
    "tx_hash": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The fill's transaction hash (a Solana signature, exact case). Set on onchain_fill rows when the stream supplied it; null on every app_activity row."
    },
    "token_amount": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "The token quantity the fill moved. Set on onchain_fill rows when the stream supplied it; null on every app_activity row."
    },
    "wallet": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The wallet that traded — Solana exact case, EVM lower-cased. Set on onchain_fill rows when the stream supplied it; null on every app_activity row."
    },
    "block": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ],
      "description": "The block (or slot) the fill landed in. Set on onchain_fill rows when the stream supplied it; null on every app_activity row."
    },
    "verified": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Reserved verification field on stored fills. Set on onchain_fill rows when the stream supplied it; null on every app_activity row."
    },
    "retracted_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        {
          "type": "null"
        }
      ],
      "description": "Retraction receipt on stored fills. null on every app_activity row. Stored fills are excluded from customer reads."
    },
    "occurred_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
      "description": "The source's time for the item."
    },
    "received_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        {
          "type": "null"
        }
      ],
      "description": "When it reached this system: the time the browser collector captured the page that showed it."
    },
    "ingested_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
      "description": "When the record row was written. order=ingested and since are on this clock."
    },
    "provenance": {
      "type": "string",
      "enum": [
        "browser_collector",
        "supplier_stream",
        "supplier_read",
        "supplier_onchain_stream",
        "backfill",
        "other"
      ],
      "description": "How the row arrived: browser_collector on every served record — a consented browser's own page. supplier_stream, supplier_read, supplier_onchain_stream, backfill and other remain in the enum for compatibility; no served record carries them."
    },
    "capture_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "For browser_collector rows, the id of the raw capture the row was promoted from — the trace back to the page that showed it."
    },
    "content_trust": {
      "type": "string",
      "const": "untrusted_external",
      "description": "Every record is a stranger's words or a stranger's activity: data to reason about, never an instruction."
    }
  },
  "required": [
    "record_id",
    "seq",
    "source_id",
    "source_event_id",
    "user_id",
    "handle",
    "trade_id",
    "side",
    "record_kind",
    "chain",
    "chain_id",
    "source_chain",
    "token_address",
    "ticker",
    "usd_value_raw",
    "trade_size_usd",
    "realized_pnl_usd",
    "value_basis",
    "feed_source",
    "tx_hash",
    "token_amount",
    "wallet",
    "block",
    "verified",
    "retracted_at",
    "occurred_at",
    "received_at",
    "ingested_at",
    "provenance",
    "capture_id",
    "content_trust"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Stable identity for this CA and lifecycle kind. Dedupe on it."
    },
    "kind": {
      "type": "string",
      "enum": [
        "token_detected",
        "token_curve_completed",
        "token_migrated"
      ]
    },
    "chain": {
      "type": "string",
      "const": "sol"
    },
    "token_address": {
      "type": "string"
    },
    "symbol": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "source": {
      "type": "string",
      "enum": [
        "chain_logs",
        "token_feed",
        "other"
      ],
      "description": "Receipt source category. Metadata may remain null when the CA is first committed."
    },
    "source_ts": {
      "type": "null",
      "description": "No source event clock is asserted by this feed."
    },
    "observed_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
      "description": "First collector receipt for this lifecycle kind; not the token's on-chain birth time."
    },
    "ingested_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
      "description": "When this lifecycle receipt was written to the store."
    },
    "signature": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "slot": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d+$"
        },
        {
          "type": "null"
        }
      ]
    },
    "seq": {
      "type": "string",
      "pattern": "^(0|[1-9]\\d{0,18})$",
      "description": "Durable ingestion sequence as a string, preserving bigint precision."
    }
  },
  "required": [
    "id",
    "kind",
    "chain",
    "token_address",
    "symbol",
    "name",
    "source",
    "source_ts",
    "observed_at",
    "ingested_at",
    "signature",
    "slot",
    "seq"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "records": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Stable identity for this CA and lifecycle kind. Dedupe on it."
          },
          "kind": {
            "type": "string",
            "enum": [
              "token_detected",
              "token_curve_completed",
              "token_migrated"
            ]
          },
          "chain": {
            "type": "string",
            "const": "sol"
          },
          "token_address": {
            "type": "string"
          },
          "symbol": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "source": {
            "type": "string",
            "enum": [
              "chain_logs",
              "token_feed",
              "other"
            ],
            "description": "Receipt source category. Metadata may remain null when the CA is first committed."
          },
          "source_ts": {
            "type": "null",
            "description": "No source event clock is asserted by this feed."
          },
          "observed_at": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
            "description": "First collector receipt for this lifecycle kind; not the token's on-chain birth time."
          },
          "ingested_at": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
            "description": "When this lifecycle receipt was written to the store."
          },
          "signature": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "slot": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d+$"
              },
              {
                "type": "null"
              }
            ]
          },
          "seq": {
            "type": "string",
            "pattern": "^(0|[1-9]\\d{0,18})$",
            "description": "Durable ingestion sequence as a string, preserving bigint precision."
          }
        },
        "required": [
          "id",
          "kind",
          "chain",
          "token_address",
          "symbol",
          "name",
          "source",
          "source_ts",
          "observed_at",
          "ingested_at",
          "signature",
          "slot",
          "seq"
        ],
        "additionalProperties": false
      }
    },
    "next_after": {
      "type": "string",
      "pattern": "^(0|[1-9]\\d{0,18})$"
    },
    "has_more": {
      "type": "boolean"
    },
    "read_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
    }
  },
  "required": [
    "records",
    "next_after",
    "has_more",
    "read_at"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "records",
    "next_cursor",
    "order",
    "filters",
    "coverage",
    "read_at"
  ],
  "properties": {
    "records": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/ThesisRecord"
      }
    },
    "next_cursor": {
      "type": [
        "string",
        "null"
      ],
      "description": "Send it back verbatim as ?cursor= with the same filters and order. order=occurred: null when the page was short. order=ingested: an empty poll returns the cursor it was given."
    },
    "order": {
      "type": "string",
      "enum": [
        "occurred",
        "ingested"
      ]
    },
    "filters": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "type": "object",
      "properties": {
        "chain": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "The canonical chain word the page was filtered on, or null."
        },
        "token": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "author": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "side": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "buy",
                "sell"
              ]
            },
            {
              "type": "null"
            }
          ],
          "description": "Always null on the thesis door."
        },
        "user_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "The user id the page was narrowed to, lower-cased, or null."
        },
        "tokens": {
          "anyOf": [
            {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            {
              "type": "null"
            }
          ],
          "description": "The token list as applied — folded, a repeat once, sorted — or null."
        }
      },
      "required": [
        "chain",
        "token",
        "author",
        "side",
        "user_id",
        "tokens"
      ],
      "additionalProperties": false
    },
    "coverage": {
      "$ref": "#/components/schemas/TableCoverage"
    },
    "read_at": {
      "type": "string",
      "format": "date-time"
    }
  }
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "records",
    "next_cursor",
    "order",
    "filters",
    "coverage",
    "read_at"
  ],
  "properties": {
    "records": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/TradeRecord"
      }
    },
    "next_cursor": {
      "type": [
        "string",
        "null"
      ],
      "description": "Send it back verbatim as ?cursor= with the same filters and order. order=occurred: null when the page was short. order=ingested: an empty poll returns the cursor it was given."
    },
    "order": {
      "type": "string",
      "enum": [
        "occurred",
        "ingested"
      ]
    },
    "filters": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "type": "object",
      "properties": {
        "chain": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "The canonical chain word the page was filtered on, or null."
        },
        "token": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "author": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "side": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "buy",
                "sell"
              ]
            },
            {
              "type": "null"
            }
          ],
          "description": "Always null on the thesis door."
        },
        "user_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "The user id the page was narrowed to, lower-cased, or null."
        },
        "tokens": {
          "anyOf": [
            {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            {
              "type": "null"
            }
          ],
          "description": "The token list as applied — folded, a repeat once, sorted — or null."
        }
      },
      "required": [
        "chain",
        "token",
        "author",
        "side",
        "user_id",
        "tokens"
      ],
      "additionalProperties": false
    },
    "coverage": {
      "$ref": "#/components/schemas/TableCoverage"
    },
    "read_at": {
      "type": "string",
      "format": "date-time"
    }
  }
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "read_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
      "description": "When this global coverage snapshot was computed. Shared for up to one second per server; record pages are read independently on every request."
    },
    "oldest_record_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        {
          "type": "null"
        }
      ]
    },
    "newest_record_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        {
          "type": "null"
        }
      ]
    },
    "record_count_24h": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Records whose source time is in the 24 hours ending at coverage.read_at."
    },
    "ingest": {
      "type": "object",
      "properties": {
        "last_persisted_at": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
            },
            {
              "type": "null"
            }
          ]
        },
        "last_processed_at": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
            },
            {
              "type": "null"
            }
          ]
        },
        "received": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "persisted": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "duplicates": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "rejected": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "retried": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "dropped": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "processed": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "failed": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "last_persisted_at",
        "last_processed_at",
        "received",
        "persisted",
        "duplicates",
        "rejected",
        "retried",
        "dropped",
        "processed",
        "failed"
      ],
      "additionalProperties": false,
      "description": "Legacy ingestion-counter shape. Null means not measured for the direct collector; supplier counters are not substituted."
    },
    "gaps_24h": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "from": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
          },
          "to": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
          },
          "recovered": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "unrecoverable": {
            "type": "boolean"
          },
          "note": {
            "type": "string"
          }
        },
        "required": [
          "from",
          "to",
          "recovered",
          "unrecoverable",
          "note"
        ],
        "additionalProperties": false
      },
      "description": "Direct-collector gap measurements, when available. An empty list does not establish lossless collection."
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Fixed, truthful statements of the data's known limits."
    }
  },
  "required": [
    "read_at",
    "oldest_record_at",
    "newest_record_at",
    "record_count_24h",
    "ingest",
    "gaps_24h",
    "notes"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "live",
        "stale",
        "empty"
      ],
      "description": "Is the collector delivering? live while collector.last_receipt_at is within the last 10 minutes and at least one row in sources is live — a chain with a usable capture within those 10 minutes. A chain that went quiet, no usable capture for longer, keeps its own stale row and freshness numbers in sources and never makes this stale. empty when no source has a row; otherwise stale."
    },
    "full_text": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "enum": [
            "live",
            "stale",
            "empty"
          ]
        },
        "freshness_at": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
            },
            {
              "type": "null"
            }
          ]
        },
        "freshness_lag_s": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "stale_chains": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Chains whose full-text source went quiet while the others stayed live."
        }
      },
      "required": [
        "status",
        "freshness_at",
        "freshness_lag_s",
        "stale_chains"
      ],
      "additionalProperties": false,
      "description": "Sources with verified full text judged on their own: live if any chain is. Unknown text is excluded."
    },
    "collector": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "enum": [
            "live",
            "stale",
            "empty"
          ]
        },
        "last_receipt_at": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
            },
            {
              "type": "null"
            }
          ],
          "description": "ACTIVITY — the last time any allowed page arrived from a collector, parsed or not."
        },
        "last_capture_at": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
            },
            {
              "type": "null"
            }
          ],
          "description": "USABLE DATA — the capture time of the newest page a parser accepted. Freshness is judged on this, never on the receipt."
        },
        "lag_s": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "status",
        "last_receipt_at",
        "last_capture_at",
        "lag_s"
      ],
      "additionalProperties": false,
      "description": "Activity beside usable data. Neither is market completeness."
    },
    "chains": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Every chain that has at least one record, canonical words, sorted."
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "theses",
              "trades"
            ]
          },
          "source": {
            "type": "string",
            "description": "Theses: the text door. Trades: the provenance. The same public words the records carry."
          },
          "text": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "full",
                  "preview",
                  "unknown"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "What text this door delivers; null for trades."
          },
          "chain": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": [
              "live",
              "stale",
              "empty"
            ]
          },
          "freshness_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
              },
              {
                "type": "null"
              }
            ],
            "description": "The capture's own time (the earlier of the collector's clock and this system's receipt) of the newest page a parser accepted for this kind and chain, so a replayed old page never reads as live; null when no such page is held."
          },
          "freshness_lag_s": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "newest_record_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
              },
              {
                "type": "null"
              }
            ]
          },
          "records": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "records_24h": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "completeness": {
            "type": "string",
            "enum": [
              "browsed_only",
              "supplier_feed",
              "backfill"
            ],
            "description": "browsed_only on every row — only what consenting installers browsed, never the market. supplier_feed and backfill remain in the enum for compatibility; no row carries them."
          }
        },
        "required": [
          "kind",
          "source",
          "text",
          "chain",
          "status",
          "freshness_at",
          "freshness_lag_s",
          "newest_record_at",
          "records",
          "records_24h",
          "completeness"
        ],
        "additionalProperties": false
      }
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "read_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
    }
  },
  "required": [
    "status",
    "full_text",
    "collector",
    "chains",
    "sources",
    "notes",
    "read_at"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "record_id": {
      "type": "string",
      "description": "Stable id of this trade, kept when the record is re-emitted (see signature)."
    },
    "seq": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Ingestion order. order=ingested walks it upward and its cursor names the last one seen. A re-emitted record takes a higher seq."
    },
    "chain": {
      "type": "string",
      "description": "The canonical chain word: solana on every record."
    },
    "signature": {
      "type": "string",
      "description": "The transaction's signature, the chain's own id for the swap: one trade per chain and signature. A record may be re-emitted with a higher seq when its decode is upgraded from logs to tx: the same signature and record_id, with corrected fields. Upsert by signature."
    },
    "slot": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ],
      "description": "The slot the transaction landed in, when known."
    },
    "occurred_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
      "description": "When the chain recorded the swap: the block time — or, when the block time was not known on arrival, the time this system received the trade."
    },
    "ingested_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
      "description": "When the record row was written. order=ingested and since are on this clock."
    },
    "wallet": {
      "type": "string",
      "description": "The trader's wallet, as the chain records it: the transaction's second signer. Present on every record: a trade is served only once its wallet is known."
    },
    "token_address": {
      "type": "string",
      "description": "The token's mint address, exact case."
    },
    "side": {
      "type": "string",
      "enum": [
        "buy",
        "sell"
      ],
      "description": "buy or sell, from the trader's side."
    },
    "usd_amount": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "The swap's size in USD; null when it is not known — a logs decode may leave it null."
    },
    "token_amount": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "The amount of the token the swap moved; null when it is not known."
    },
    "venue": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "pumpswap",
            "pumpfun",
            "meteora",
            "raydium",
            "orca",
            "other"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "The venue whose pool filled the swap: other for a venue not named here, null when it was not identified."
    },
    "route": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "dflow",
            "jupiter",
            "direct",
            "other"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "How the swap reached the pool: through an aggregator (dflow, jupiter), direct, or other; null when it was not identified."
    },
    "fomo_signer_verified": {
      "type": "boolean",
      "description": "true when this system confirmed FOMO's app wallet as the transaction's fee payer; false when that was not confirmed — every record decoded from logs alone (decode_source logs) reads false until its full transaction is read. Filter on true when only confirmed FOMO trades will do."
    },
    "source": {
      "type": "string",
      "const": "chain",
      "description": "chain on every record: read from public chain data, never from the app."
    },
    "decode_source": {
      "type": "string",
      "enum": [
        "logs",
        "tx"
      ],
      "description": "How the trade was decoded. logs — from the transaction's logs: exact for a single-venue pump.fun, PumpSwap or CLMM swap; usd_amount may be null. tx — from the full transaction: exact amounts, on every venue. A logs record may be re-emitted as tx (see signature)."
    }
  },
  "required": [
    "record_id",
    "seq",
    "chain",
    "signature",
    "slot",
    "occurred_at",
    "ingested_at",
    "wallet",
    "token_address",
    "side",
    "usd_amount",
    "token_amount",
    "venue",
    "route",
    "fomo_signer_verified",
    "source",
    "decode_source"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "records": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "record_id": {
            "type": "string",
            "description": "Stable id of this record. Dedupe on it."
          },
          "seq": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991,
            "description": "Ingestion order. order=ingested walks it upward and its cursor names the last one seen."
          },
          "source_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The source's own id for this item."
          },
          "source_event_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The source's event id, when it publishes one beside the item id: a home_feed trade carries the feed item's id, the same as source_id — null on every thesis and on every token_swaps and profile_swaps trade."
          },
          "user_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The trader's stable id at the source, when the door carries it."
          },
          "handle": {
            "type": "string",
            "description": "The trader's handle, lower-cased, without the @."
          },
          "trade_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The position id at the source, when the door carries it."
          },
          "thesis_key": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The one logical thesis this record observes. Records are never merged: each capture that changes what a thesis says (its text, token, chain or post time) arrives as its own record with its own seq, and shares this key. Group by it — a later record carrying a key you already hold is an update to that thesis, found by the same incremental walk or stream, never by a rescan. Keep the most complete text (full, then unknown, then preview): a later preview never replaces a full text. Null only on a row written before the key existed."
          },
          "thesis_key_basis": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "own",
                  "relay_event",
                  "matched",
                  "ambiguous"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "How the key was assigned: own — this record opened the thesis, under its platform thesis id; matched — the key was inherited from an earlier observation of the same post: one with the same platform thesis id, or exactly one earlier thesis with the same chain, author and token posted within 1 s and no conflicting id (that observation may not itself be served: a key you do not hold yet is a thesis new to you); ambiguous — several earlier theses matched, so this record opened its own rather than guess. relay_event remains in the enum for compatibility; no served record carries it."
          },
          "chain": {
            "type": "string",
            "description": "The canonical chain word — solana (alias sol) · robinhood (rh, hood) · ethereum (eth) · base · bsc · arc · monad · hyperliquid · polygon · arbitrum · unknown."
          },
          "chain_id": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "The numeric chain id when known."
          },
          "source_chain": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The source's own chain word, verbatim, when it sent one — null on every served record: the app names a network by number (chain_id), never by word."
          },
          "token_address": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Solana exact case; EVM lower-cased."
          },
          "ticker": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The token's ticker as the app shows it: the record's own, or, when the page it came from carried none, the newest one a thesis record served here showed for the same token on the same chain. Null until the app has shown one for this token. Filled when the record is read, so a record read again may carry a ticker it did not before."
          },
          "text": {
            "type": "string",
            "description": "The thesis body. See text_completeness for whether it is the whole of it."
          },
          "text_completeness": {
            "type": "string",
            "enum": [
              "full",
              "preview",
              "unknown"
            ],
            "description": "full — the whole body. preview — the app's own 300-character cut: its token page shows a longer thesis that way, ending in …; the full text arrives under the same thesis_key only when the home feed carries that thesis, so keep the most complete record per key. unknown remains in the enum for compatibility; no served record carries it."
          },
          "text_door": {
            "type": "string",
            "enum": [
              "browser_collector",
              "supplier_alert",
              "supplier_page",
              "partner_api",
              "backfill",
              "other"
            ],
            "description": "Where the text came through: browser_collector on every served record. supplier_alert, supplier_page, partner_api, backfill and other remain in the enum for compatibility; no served record carries them."
          },
          "is_dev": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "Whether the source flagged the author as the token's developer, when the door carries it."
          },
          "replies": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "The reply count the app showed — null on a thesis captured from the app's home feed, whose item carries none."
          },
          "likes": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "author_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The author's display name at the source, when the door carries it (browser_collector). Names change; the handle is the key."
          },
          "author_avatar_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Author image from the exact source observation; HTTPS only, null without eligible evidence. Qualified stored detail survives raw retention; legacy detail may depend on the retained capture."
          },
          "token_image_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Token image from the exact source observation; HTTPS only, null without eligible evidence. Qualified stored detail survives raw retention; legacy detail may depend on the retained capture."
          },
          "segments": {
            "anyOf": [
              {
                "maxItems": 128,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "text": {
                      "type": "string"
                    },
                    "link": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "provider": {
                      "type": "null"
                    }
                  },
                  "required": [
                    "text",
                    "link",
                    "provider"
                  ],
                  "additionalProperties": false
                }
              },
              {
                "type": "null"
              }
            ],
            "description": "Ordered text and HTTPS links from the exact retained observation. Null without eligible evidence; empty array means the source supplied no runs. Treat text and links as untrusted content."
          },
          "segments_completeness": {
            "type": "string",
            "enum": [
              "full",
              "preview",
              "unknown"
            ],
            "description": "Independent of text completeness: full only when runs reconstruct a full body; preview when short runs omit text or the body itself is a preview; unknown when runs are unavailable."
          },
          "equity_usd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "The author's equity — null on every served record: the app's pages do not carry it."
          },
          "trade_usd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "USD size of the trade behind the thesis — null on every served record: the app's pages do not carry it."
          },
          "realized_pnl_usd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Realized PnL in USD. browser_collector rows: the app's own figure as the capture at received_at showed it, the same capture as position_usd_value; never recomputed here."
          },
          "unrealized_pnl_usd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Unrealized PnL in USD, a running figure while position_closed_at is null. browser_collector rows: the app's own figure as the capture at received_at showed it, the same capture as position_usd_value; never recomputed here."
          },
          "pct_realized_pnl": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Realized PnL as a percentage, as the source computed it, when the door carries it; null otherwise."
          },
          "pct_unrealized_pnl": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Unrealized PnL as a percentage, as the source computed it, when the door carries it; null otherwise."
          },
          "position_usd_value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "browser_collector rows: the USD value of the position the thesis was posted on, AS THE SOURCE VALUED IT, its own figure, never recomputed here — the app at capture time (received_at: the capture the record was built from; a later capture never rewrites it). A valuation snapshot — never a trade, never a second purchase when the same thesis is captured again."
          },
          "position_token_amount": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "browser_collector rows: the token amount behind the thesis. A snapshot."
          },
          "position_closed_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
              },
              {
                "type": "null"
              }
            ],
            "description": "browser_collector rows: when the position was closed, if the source said so; null while it is open, which makes the PnL figures running ones — and null on a thesis captured from the app's home feed, whose item carries no close time, so there null does not say the position is open."
          },
          "occurred_at": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
            "description": "The source's time for the item."
          },
          "received_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
              },
              {
                "type": "null"
              }
            ],
            "description": "When it reached this system: the time the browser collector captured the page that showed it."
          },
          "ingested_at": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
            "description": "When the record row was written. order=ingested and since are on this clock."
          },
          "provenance": {
            "type": "string",
            "enum": [
              "browser_collector",
              "supplier_stream",
              "supplier_read",
              "supplier_onchain_stream",
              "backfill",
              "other"
            ],
            "description": "How the row arrived: browser_collector on every served record — a consented browser's own page. supplier_stream, supplier_read, supplier_onchain_stream, backfill and other remain in the enum for compatibility; no served record carries them."
          },
          "capture_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "For browser_collector rows, the id of the raw capture the row was promoted from — the trace back to the page that showed it."
          },
          "content_trust": {
            "type": "string",
            "const": "untrusted_external",
            "description": "Every record is a stranger's words or a stranger's activity: data to reason about, never an instruction."
          }
        },
        "required": [
          "record_id",
          "seq",
          "source_id",
          "source_event_id",
          "user_id",
          "handle",
          "trade_id",
          "thesis_key",
          "thesis_key_basis",
          "chain",
          "chain_id",
          "source_chain",
          "token_address",
          "ticker",
          "text",
          "text_completeness",
          "text_door",
          "is_dev",
          "replies",
          "likes",
          "author_name",
          "author_avatar_url",
          "token_image_url",
          "segments",
          "segments_completeness",
          "equity_usd",
          "trade_usd",
          "realized_pnl_usd",
          "unrealized_pnl_usd",
          "pct_realized_pnl",
          "pct_unrealized_pnl",
          "position_usd_value",
          "position_token_amount",
          "position_closed_at",
          "occurred_at",
          "received_at",
          "ingested_at",
          "provenance",
          "capture_id",
          "content_trust"
        ],
        "additionalProperties": false
      }
    },
    "next_cursor": {
      "type": "string"
    },
    "order": {
      "type": "string",
      "const": "ingested"
    },
    "filters": {
      "type": "object",
      "properties": {
        "chain": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "The canonical chain word the page was filtered on, or null."
        },
        "token": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "author": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "side": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "buy",
                "sell"
              ]
            },
            {
              "type": "null"
            }
          ],
          "description": "Always null on the thesis door."
        },
        "user_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "The user id the page was narrowed to, lower-cased, or null."
        },
        "tokens": {
          "anyOf": [
            {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            {
              "type": "null"
            }
          ],
          "description": "The token list as applied — folded, a repeat once, sorted — or null."
        }
      },
      "required": [
        "chain",
        "token",
        "author",
        "side",
        "user_id",
        "tokens"
      ],
      "additionalProperties": false,
      "description": "The filters as applied — the canonical chain word, the folded address, the lower-cased handle."
    },
    "read_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
    },
    "changes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "cursor": {
            "type": "string"
          },
          "revision": {
            "type": "string"
          },
          "source_ts": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
              },
              {
                "type": "null"
              }
            ]
          },
          "captured_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
              },
              {
                "type": "null"
              }
            ]
          },
          "received_at": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
          },
          "ingested_at": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
          }
        },
        "required": [
          "cursor",
          "revision",
          "source_ts",
          "captured_at",
          "received_at",
          "ingested_at"
        ],
        "additionalProperties": false
      }
    },
    "cursor_version": {
      "type": "number",
      "const": 2
    },
    "has_more": {
      "type": "boolean"
    }
  },
  "required": [
    "records",
    "next_cursor",
    "order",
    "filters",
    "read_at",
    "changes",
    "cursor_version",
    "has_more"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "records": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "record_id": {
            "type": "string",
            "description": "Stable id of this record. Dedupe on it."
          },
          "seq": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991,
            "description": "Ingestion order. order=ingested walks it upward and its cursor names the last one seen."
          },
          "source_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The source's own id for this item."
          },
          "source_event_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The source's event id, when it publishes one beside the item id: a home_feed trade carries the feed item's id, the same as source_id — null on every thesis and on every token_swaps and profile_swaps trade."
          },
          "user_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The trader's stable id at the source, when the door carries it."
          },
          "handle": {
            "type": "string",
            "description": "The trader's handle, lower-cased, without the @."
          },
          "trade_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The position id at the source, when the door carries it."
          },
          "side": {
            "type": "string",
            "enum": [
              "buy",
              "sell"
            ]
          },
          "record_kind": {
            "type": "string",
            "enum": [
              "app_activity",
              "onchain_fill"
            ],
            "description": "Every served row is app_activity: activity the app showed, never an on-chain fill. onchain_fill is retained for schema compatibility with stored audit rows, excluded from customer reads."
          },
          "chain": {
            "type": "string",
            "description": "The canonical chain word — solana (alias sol) · robinhood (rh, hood) · ethereum (eth) · base · bsc · arc · monad · hyperliquid · polygon · arbitrum · unknown."
          },
          "chain_id": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "The numeric chain id when known."
          },
          "source_chain": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The source's own chain word, verbatim, when it sent one — null on every served record: the app names a network by number (chain_id), never by word."
          },
          "token_address": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Solana exact case; EVM lower-cased."
          },
          "ticker": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The token's ticker as the app shows it: the record's own, or, when the page it came from carried none, the newest one a thesis record served here showed for the same token on the same chain. Null until the app has shown one for this token. Filled when the record is read, so a record read again may carry a ticker it did not before."
          },
          "usd_value_raw": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "The source's USD figure as sent, whatever it meant."
          },
          "trade_size_usd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "The size of the trade in USD: the app's own swap amount (value_basis source_field) — on profile_swaps, the USD spent on a buy or received on a sell. Null when the event named no USD amount (value_basis unknown): a home_feed large buy or sell gives a token quantity and the position's value, never the trade's, so only its closing sell carries a size."
          },
          "realized_pnl_usd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Realized PnL in USD — null on every served record: the app's swap events carry none."
          },
          "value_basis": {
            "type": "string",
            "enum": [
              "parsed_text",
              "source_field",
              "unknown"
            ],
            "description": "How trade_size_usd was filled: source_field — the app's own structured USD amount on the event; unknown — the event named none, so trade_size_usd is null. parsed_text remains in the enum for compatibility; no served record carries it."
          },
          "feed_source": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Which of the app's feeds showed the event: token_swaps — a token's swap feed; profile_swaps — a user's own swaps on their profile; home_feed — the app's home feed (large buys, large sells and closing sells) under the feed item's own id, which no swap id joins. A swap both token_swaps and profile_swaps showed is one record, so count unique swaps from those two."
          },
          "tx_hash": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The fill's transaction hash (a Solana signature, exact case). Set on onchain_fill rows when the stream supplied it; null on every app_activity row."
          },
          "token_amount": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "The token quantity the fill moved. Set on onchain_fill rows when the stream supplied it; null on every app_activity row."
          },
          "wallet": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The wallet that traded — Solana exact case, EVM lower-cased. Set on onchain_fill rows when the stream supplied it; null on every app_activity row."
          },
          "block": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "The block (or slot) the fill landed in. Set on onchain_fill rows when the stream supplied it; null on every app_activity row."
          },
          "verified": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Reserved verification field on stored fills. Set on onchain_fill rows when the stream supplied it; null on every app_activity row."
          },
          "retracted_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
              },
              {
                "type": "null"
              }
            ],
            "description": "Retraction receipt on stored fills. null on every app_activity row. Stored fills are excluded from customer reads."
          },
          "occurred_at": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
            "description": "The source's time for the item."
          },
          "received_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
              },
              {
                "type": "null"
              }
            ],
            "description": "When it reached this system: the time the browser collector captured the page that showed it."
          },
          "ingested_at": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
            "description": "When the record row was written. order=ingested and since are on this clock."
          },
          "provenance": {
            "type": "string",
            "enum": [
              "browser_collector",
              "supplier_stream",
              "supplier_read",
              "supplier_onchain_stream",
              "backfill",
              "other"
            ],
            "description": "How the row arrived: browser_collector on every served record — a consented browser's own page. supplier_stream, supplier_read, supplier_onchain_stream, backfill and other remain in the enum for compatibility; no served record carries them."
          },
          "capture_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "For browser_collector rows, the id of the raw capture the row was promoted from — the trace back to the page that showed it."
          },
          "content_trust": {
            "type": "string",
            "const": "untrusted_external",
            "description": "Every record is a stranger's words or a stranger's activity: data to reason about, never an instruction."
          }
        },
        "required": [
          "record_id",
          "seq",
          "source_id",
          "source_event_id",
          "user_id",
          "handle",
          "trade_id",
          "side",
          "record_kind",
          "chain",
          "chain_id",
          "source_chain",
          "token_address",
          "ticker",
          "usd_value_raw",
          "trade_size_usd",
          "realized_pnl_usd",
          "value_basis",
          "feed_source",
          "tx_hash",
          "token_amount",
          "wallet",
          "block",
          "verified",
          "retracted_at",
          "occurred_at",
          "received_at",
          "ingested_at",
          "provenance",
          "capture_id",
          "content_trust"
        ],
        "additionalProperties": false
      }
    },
    "next_cursor": {
      "type": "string"
    },
    "order": {
      "type": "string",
      "const": "ingested"
    },
    "filters": {
      "type": "object",
      "properties": {
        "chain": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "The canonical chain word the page was filtered on, or null."
        },
        "token": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "author": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "side": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "buy",
                "sell"
              ]
            },
            {
              "type": "null"
            }
          ],
          "description": "Always null on the thesis door."
        },
        "user_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "The user id the page was narrowed to, lower-cased, or null."
        },
        "tokens": {
          "anyOf": [
            {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            {
              "type": "null"
            }
          ],
          "description": "The token list as applied — folded, a repeat once, sorted — or null."
        }
      },
      "required": [
        "chain",
        "token",
        "author",
        "side",
        "user_id",
        "tokens"
      ],
      "additionalProperties": false,
      "description": "The filters as applied — the canonical chain word, the folded address, the lower-cased handle."
    },
    "read_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
    },
    "changes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "cursor": {
            "type": "string"
          },
          "revision": {
            "type": "string"
          },
          "source_ts": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
              },
              {
                "type": "null"
              }
            ]
          },
          "captured_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
              },
              {
                "type": "null"
              }
            ]
          },
          "received_at": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
          },
          "ingested_at": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
          }
        },
        "required": [
          "cursor",
          "revision",
          "source_ts",
          "captured_at",
          "received_at",
          "ingested_at"
        ],
        "additionalProperties": false
      }
    },
    "cursor_version": {
      "type": "number",
      "const": 2
    },
    "has_more": {
      "type": "boolean"
    }
  },
  "required": [
    "records",
    "next_cursor",
    "order",
    "filters",
    "read_at",
    "changes",
    "cursor_version",
    "has_more"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "records": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "record_id": {
            "type": "string",
            "description": "Stable id of this trade, kept when the record is re-emitted (see signature)."
          },
          "seq": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991,
            "description": "Ingestion order. order=ingested walks it upward and its cursor names the last one seen. A re-emitted record takes a higher seq."
          },
          "chain": {
            "type": "string",
            "description": "The canonical chain word: solana on every record."
          },
          "signature": {
            "type": "string",
            "description": "The transaction's signature, the chain's own id for the swap: one trade per chain and signature. A record may be re-emitted with a higher seq when its decode is upgraded from logs to tx: the same signature and record_id, with corrected fields. Upsert by signature."
          },
          "slot": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "The slot the transaction landed in, when known."
          },
          "occurred_at": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
            "description": "When the chain recorded the swap: the block time — or, when the block time was not known on arrival, the time this system received the trade."
          },
          "ingested_at": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
            "description": "When the record row was written. order=ingested and since are on this clock."
          },
          "wallet": {
            "type": "string",
            "description": "The trader's wallet, as the chain records it: the transaction's second signer. Present on every record: a trade is served only once its wallet is known."
          },
          "token_address": {
            "type": "string",
            "description": "The token's mint address, exact case."
          },
          "side": {
            "type": "string",
            "enum": [
              "buy",
              "sell"
            ],
            "description": "buy or sell, from the trader's side."
          },
          "usd_amount": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "The swap's size in USD; null when it is not known — a logs decode may leave it null."
          },
          "token_amount": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "The amount of the token the swap moved; null when it is not known."
          },
          "venue": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "pumpswap",
                  "pumpfun",
                  "meteora",
                  "raydium",
                  "orca",
                  "other"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "The venue whose pool filled the swap: other for a venue not named here, null when it was not identified."
          },
          "route": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "dflow",
                  "jupiter",
                  "direct",
                  "other"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "How the swap reached the pool: through an aggregator (dflow, jupiter), direct, or other; null when it was not identified."
          },
          "fomo_signer_verified": {
            "type": "boolean",
            "description": "true when this system confirmed FOMO's app wallet as the transaction's fee payer; false when that was not confirmed — every record decoded from logs alone (decode_source logs) reads false until its full transaction is read. Filter on true when only confirmed FOMO trades will do."
          },
          "source": {
            "type": "string",
            "const": "chain",
            "description": "chain on every record: read from public chain data, never from the app."
          },
          "decode_source": {
            "type": "string",
            "enum": [
              "logs",
              "tx"
            ],
            "description": "How the trade was decoded. logs — from the transaction's logs: exact for a single-venue pump.fun, PumpSwap or CLMM swap; usd_amount may be null. tx — from the full transaction: exact amounts, on every venue. A logs record may be re-emitted as tx (see signature)."
          }
        },
        "required": [
          "record_id",
          "seq",
          "chain",
          "signature",
          "slot",
          "occurred_at",
          "ingested_at",
          "wallet",
          "token_address",
          "side",
          "usd_amount",
          "token_amount",
          "venue",
          "route",
          "fomo_signer_verified",
          "source",
          "decode_source"
        ],
        "additionalProperties": false
      }
    },
    "next_cursor": {
      "type": "string"
    },
    "order": {
      "type": "string",
      "const": "ingested"
    },
    "filters": {
      "type": "object",
      "properties": {
        "chain": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "The canonical chain word the page was filtered on, or null."
        },
        "token": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "wallet": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "side": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "buy",
                "sell"
              ]
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "chain",
        "token",
        "wallet",
        "side"
      ],
      "additionalProperties": false,
      "description": "The filters as applied."
    },
    "read_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
    },
    "changes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "cursor": {
            "type": "string"
          },
          "revision": {
            "type": "string"
          },
          "source_ts": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
              },
              {
                "type": "null"
              }
            ]
          },
          "captured_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
              },
              {
                "type": "null"
              }
            ]
          },
          "received_at": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
          },
          "ingested_at": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
          }
        },
        "required": [
          "cursor",
          "revision",
          "source_ts",
          "captured_at",
          "received_at",
          "ingested_at"
        ],
        "additionalProperties": false
      }
    },
    "cursor_version": {
      "type": "number",
      "const": 2
    },
    "has_more": {
      "type": "boolean"
    }
  },
  "required": [
    "records",
    "next_cursor",
    "order",
    "filters",
    "read_at",
    "changes",
    "cursor_version",
    "has_more"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "records",
    "next_cursor",
    "order",
    "filters",
    "read_at"
  ],
  "properties": {
    "records": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/ChainTradeRecord"
      }
    },
    "next_cursor": {
      "type": [
        "string",
        "null"
      ],
      "description": "Send it back verbatim as ?cursor= with the same filters and order. order=occurred: null when the page was short. order=ingested: an empty poll returns the cursor it was given."
    },
    "order": {
      "type": "string",
      "enum": [
        "occurred",
        "ingested"
      ]
    },
    "filters": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "type": "object",
      "properties": {
        "chain": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "The canonical chain word the page was filtered on, or null."
        },
        "token": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "wallet": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "side": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "buy",
                "sell"
              ]
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "chain",
        "token",
        "wallet",
        "side"
      ],
      "additionalProperties": false,
      "description": "The filters as applied."
    },
    "read_at": {
      "type": "string",
      "format": "date-time"
    }
  }
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string",
          "description": "Names the parameter that was refused, never its value."
        },
        "type": {
          "type": "string"
        },
        "request_id": {
          "description": "Quote it when you write to support.",
          "type": "string"
        }
      },
      "required": [
        "code",
        "message",
        "type"
      ],
      "additionalProperties": {}
    }
  },
  "required": [
    "error"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "user_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The person's stable id at the source, when a stored record or identity carries it. Store this, not the handle."
    },
    "handle": {
      "type": "string",
      "description": "Lower-cased, without the @. People rename — do not key on it."
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The display name, when a record or the leaderboard carries one."
    },
    "avatar_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The picture the leaderboard published, https only, or null."
    },
    "x_handle": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Reserved for independently verified X identity; currently null. A source-declared link is carried separately in x_profile."
    },
    "x_profile": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "handle": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_]{1,15}$"
            },
            "source": {
              "type": "string",
              "const": "fomo"
            },
            "observed_at": {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
            },
            "identity_verified": {
              "type": "boolean",
              "const": false
            }
          },
          "required": [
            "handle",
            "source",
            "observed_at",
            "identity_verified"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "The X profile explicitly published by FOMO for this user id, with its observation time. Source-declared, not identity verification. Only explicitly public actors in the freshest trusted board snapshot qualify; older windows and directory socials are not fallbacks. Null after removal, absence, privacy restriction or expired evidence."
    },
    "profile_details": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "bio": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "banner_url": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "avatar_url": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "followers": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            },
            "following": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            },
            "source": {
              "type": "string",
              "const": "fomo"
            },
            "observed_at": {
              "type": "object",
              "properties": {
                "bio": {
                  "anyOf": [
                    {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "banner_url": {
                  "anyOf": [
                    {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "avatar_url": {
                  "anyOf": [
                    {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "followers": {
                  "anyOf": [
                    {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "following": {
                  "anyOf": [
                    {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "bio",
                "banner_url",
                "avatar_url",
                "followers",
                "following"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "bio",
            "banner_url",
            "avatar_url",
            "followers",
            "following",
            "source",
            "observed_at"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "Public profile fields for an explicitly public native user in the one freshest trusted FOMO board snapshot. Supplemental snapshot coverage only: actors outside that snapshot are null and coverage can change as boards rotate. No older-window fallback. Each present field has its observation clock; absent fields are null without a clock, explicit source null retains its clock. Counts are source-reported, not a verified social graph. Evidence expires after 26 hours and may disappear under retention."
    },
    "solana_wallet": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Present only when FOMO's own trade page attested this wallet and its persisted capture proof remains trusted. The page names the person's user id beside the wallet that traded the position. Proof survives raw-capture expiry; revoked or unknown proof returns null. Never one resolved from a handle. This Solana address is FOMO's account address for the person, not an on-chain trading wallet: none of these addresses signs a FOMO swap on chain, and those checked hold no account and no token account. The Solana wallet that signs and holds is solana_signer."
    },
    "evm_wallet": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Present only when FOMO's own trade page attested this wallet and its persisted capture proof remains trusted. The page names the person's user id beside the wallet that traded the position. Proof survives raw-capture expiry; revoked or unknown proof returns null. Never one resolved from a handle."
    },
    "solana_signer": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "wallet": {
              "type": "string",
              "description": "The Solana wallet that signs this person's FOMO trades on chain — the trader's own signer beside FOMO's app wallet on each swap — and holds what they trade."
            },
            "method": {
              "type": "string",
              "enum": [
                "chain_cooccurrence",
                "cross_chain_deposit"
              ],
              "description": "chain_cooccurrence: a FOMO swap on chain matched exactly one trade the app showed for this person — the same token and side, within 5 seconds, the USD amount within 2 % or $0.25 (and cross-chain deposits may count beside them). cross_chain_deposit (1.7.0): every match is a deposit this wallet made to pay for a FOMO buy on another chain, matching exactly one EVM buy the app showed for this person within 10 seconds, the USD amount within 3 % or $0.50, and that buy exactly one deposit."
            },
            "matches": {
              "type": "integer",
              "minimum": 2,
              "maximum": 9007199254740991,
              "description": "Matches between this person and this wallet: swaps on chain and cross-chain deposits together. At least 2; the wallet holds at least 80 % of this person's matches, and this person at least 80 % of the wallet's."
            },
            "first_matched_at": {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
              "description": "Block time of the first matched swap or deposit."
            },
            "last_matched_at": {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
              "description": "Block time of the newest matched swap or deposit."
            },
            "sample_signature": {
              "type": "string",
              "description": "The newest matched swap's or deposit's transaction signature: look it up on chain to see this wallet sign it."
            }
          },
          "required": [
            "wallet",
            "method",
            "matches",
            "first_matched_at",
            "last_matched_at",
            "sample_signature"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "INFERRED, NOT ATTESTED: the Solana wallet that signs this person's trades on chain, with the evidence behind the inference. FOMO publishes no map from a user to this wallet; it is read from FOMO's own app-signed swaps that coincide with the trades the app showed for this person, and from the deposits that pay for their buys on other chains, counted only from trusted collector captures after the provenance floor and only while the person is public. Null without at least 2 such matches holding 80 % both ways. A different kind of address from solana_wallet."
    },
    "linked_wallets": {
      "maxItems": 25,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "platform": {
            "type": "string",
            "enum": [
              "pump",
              "axiom",
              "terminal"
            ],
            "description": "Whose public words name this wallet beside the X account: pump — a pump.fun account, served only where pump.fun's own payout board also names the account's numeric X id (its profile handle alone is self-declared); axiom — the caller of an Axiom call; terminal — another trading terminal's wallet profile or call."
          },
          "wallet": {
            "type": "string",
            "description": "The wallet as the platform names it: Solana exact, EVM lower-cased."
          },
          "chain_family": {
            "type": "string",
            "enum": [
              "solana",
              "evm"
            ],
            "description": "The address's family."
          },
          "via": {
            "type": "string",
            "const": "x_handle",
            "description": "x_handle: joined through the X username the platform names beside the wallet."
          },
          "level": {
            "type": "string",
            "const": "x_name_match",
            "description": "x_name_match: the handle and the display name both agree. The only level served; a handle alone links nothing."
          },
          "x_handle": {
            "type": "string",
            "pattern": "^[a-z0-9_]{1,15}$",
            "description": "The X username the platform names, lower-cased without the @ — equal to the person's handle."
          },
          "observed_at": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
            "description": "The platform's newest observation of this claim."
          }
        },
        "required": [
          "platform",
          "wallet",
          "chain_family",
          "via",
          "level",
          "x_handle",
          "observed_at"
        ],
        "additionalProperties": false
      },
      "description": "Wallets other platforms publish for the X account this person logged in with, newest first, at most 25; empty when none qualifies. A platform's claim joined by X account, never a verification and never attested: the person's FOMO handle equals the X username the platform names beside the wallet, AND FOMO's display name for the person equals the X display name a platform shows for that username (compared case-folded, spaces collapsed; a display name equal to the handle never counts). Nothing for a handle two people show, nor for a wallet a platform also names for another X account, nor while the person is private. A different kind of address from solana_wallet, evm_wallet and solana_signer, and never merged into them."
    },
    "resolution": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "verified",
            "probable",
            "partial"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "How far the sources behind a resolved identity agreed; null when none was resolved."
    },
    "basis": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "theses",
          "trades",
          "identity",
          "leaderboard"
        ]
      },
      "description": "Which stored tables named the person."
    }
  },
  "required": [
    "user_id",
    "handle",
    "name",
    "avatar_url",
    "x_handle",
    "x_profile",
    "profile_details",
    "solana_wallet",
    "evm_wallet",
    "solana_signer",
    "linked_wallets",
    "resolution",
    "basis"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "user": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "user_id": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "The person's stable id at the source, when a stored record or identity carries it. Store this, not the handle."
            },
            "handle": {
              "type": "string",
              "description": "Lower-cased, without the @. People rename — do not key on it."
            },
            "name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "The display name, when a record or the leaderboard carries one."
            },
            "avatar_url": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "The picture the leaderboard published, https only, or null."
            },
            "x_handle": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Reserved for independently verified X identity; currently null. A source-declared link is carried separately in x_profile."
            },
            "x_profile": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "handle": {
                      "type": "string",
                      "pattern": "^[A-Za-z0-9_]{1,15}$"
                    },
                    "source": {
                      "type": "string",
                      "const": "fomo"
                    },
                    "observed_at": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                    },
                    "identity_verified": {
                      "type": "boolean",
                      "const": false
                    }
                  },
                  "required": [
                    "handle",
                    "source",
                    "observed_at",
                    "identity_verified"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ],
              "description": "The X profile explicitly published by FOMO for this user id, with its observation time. Source-declared, not identity verification. Only explicitly public actors in the freshest trusted board snapshot qualify; older windows and directory socials are not fallbacks. Null after removal, absence, privacy restriction or expired evidence."
            },
            "profile_details": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "bio": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "banner_url": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "avatar_url": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "followers": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "following": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "source": {
                      "type": "string",
                      "const": "fomo"
                    },
                    "observed_at": {
                      "type": "object",
                      "properties": {
                        "bio": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "banner_url": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "avatar_url": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "followers": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "following": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "bio",
                        "banner_url",
                        "avatar_url",
                        "followers",
                        "following"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "bio",
                    "banner_url",
                    "avatar_url",
                    "followers",
                    "following",
                    "source",
                    "observed_at"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ],
              "description": "Public profile fields for an explicitly public native user in the one freshest trusted FOMO board snapshot. Supplemental snapshot coverage only: actors outside that snapshot are null and coverage can change as boards rotate. No older-window fallback. Each present field has its observation clock; absent fields are null without a clock, explicit source null retains its clock. Counts are source-reported, not a verified social graph. Evidence expires after 26 hours and may disappear under retention."
            },
            "solana_wallet": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Present only when FOMO's own trade page attested this wallet and its persisted capture proof remains trusted. The page names the person's user id beside the wallet that traded the position. Proof survives raw-capture expiry; revoked or unknown proof returns null. Never one resolved from a handle. This Solana address is FOMO's account address for the person, not an on-chain trading wallet: none of these addresses signs a FOMO swap on chain, and those checked hold no account and no token account. The Solana wallet that signs and holds is solana_signer."
            },
            "evm_wallet": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Present only when FOMO's own trade page attested this wallet and its persisted capture proof remains trusted. The page names the person's user id beside the wallet that traded the position. Proof survives raw-capture expiry; revoked or unknown proof returns null. Never one resolved from a handle."
            },
            "solana_signer": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "wallet": {
                      "type": "string",
                      "description": "The Solana wallet that signs this person's FOMO trades on chain — the trader's own signer beside FOMO's app wallet on each swap — and holds what they trade."
                    },
                    "method": {
                      "type": "string",
                      "enum": [
                        "chain_cooccurrence",
                        "cross_chain_deposit"
                      ],
                      "description": "chain_cooccurrence: a FOMO swap on chain matched exactly one trade the app showed for this person — the same token and side, within 5 seconds, the USD amount within 2 % or $0.25 (and cross-chain deposits may count beside them). cross_chain_deposit (1.7.0): every match is a deposit this wallet made to pay for a FOMO buy on another chain, matching exactly one EVM buy the app showed for this person within 10 seconds, the USD amount within 3 % or $0.50, and that buy exactly one deposit."
                    },
                    "matches": {
                      "type": "integer",
                      "minimum": 2,
                      "maximum": 9007199254740991,
                      "description": "Matches between this person and this wallet: swaps on chain and cross-chain deposits together. At least 2; the wallet holds at least 80 % of this person's matches, and this person at least 80 % of the wallet's."
                    },
                    "first_matched_at": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
                      "description": "Block time of the first matched swap or deposit."
                    },
                    "last_matched_at": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
                      "description": "Block time of the newest matched swap or deposit."
                    },
                    "sample_signature": {
                      "type": "string",
                      "description": "The newest matched swap's or deposit's transaction signature: look it up on chain to see this wallet sign it."
                    }
                  },
                  "required": [
                    "wallet",
                    "method",
                    "matches",
                    "first_matched_at",
                    "last_matched_at",
                    "sample_signature"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ],
              "description": "INFERRED, NOT ATTESTED: the Solana wallet that signs this person's trades on chain, with the evidence behind the inference. FOMO publishes no map from a user to this wallet; it is read from FOMO's own app-signed swaps that coincide with the trades the app showed for this person, and from the deposits that pay for their buys on other chains, counted only from trusted collector captures after the provenance floor and only while the person is public. Null without at least 2 such matches holding 80 % both ways. A different kind of address from solana_wallet."
            },
            "linked_wallets": {
              "maxItems": 25,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "platform": {
                    "type": "string",
                    "enum": [
                      "pump",
                      "axiom",
                      "terminal"
                    ],
                    "description": "Whose public words name this wallet beside the X account: pump — a pump.fun account, served only where pump.fun's own payout board also names the account's numeric X id (its profile handle alone is self-declared); axiom — the caller of an Axiom call; terminal — another trading terminal's wallet profile or call."
                  },
                  "wallet": {
                    "type": "string",
                    "description": "The wallet as the platform names it: Solana exact, EVM lower-cased."
                  },
                  "chain_family": {
                    "type": "string",
                    "enum": [
                      "solana",
                      "evm"
                    ],
                    "description": "The address's family."
                  },
                  "via": {
                    "type": "string",
                    "const": "x_handle",
                    "description": "x_handle: joined through the X username the platform names beside the wallet."
                  },
                  "level": {
                    "type": "string",
                    "const": "x_name_match",
                    "description": "x_name_match: the handle and the display name both agree. The only level served; a handle alone links nothing."
                  },
                  "x_handle": {
                    "type": "string",
                    "pattern": "^[a-z0-9_]{1,15}$",
                    "description": "The X username the platform names, lower-cased without the @ — equal to the person's handle."
                  },
                  "observed_at": {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
                    "description": "The platform's newest observation of this claim."
                  }
                },
                "required": [
                  "platform",
                  "wallet",
                  "chain_family",
                  "via",
                  "level",
                  "x_handle",
                  "observed_at"
                ],
                "additionalProperties": false
              },
              "description": "Wallets other platforms publish for the X account this person logged in with, newest first, at most 25; empty when none qualifies. A platform's claim joined by X account, never a verification and never attested: the person's FOMO handle equals the X username the platform names beside the wallet, AND FOMO's display name for the person equals the X display name a platform shows for that username (compared case-folded, spaces collapsed; a display name equal to the handle never counts). Nothing for a handle two people show, nor for a wallet a platform also names for another X account, nor while the person is private. A different kind of address from solana_wallet, evm_wallet and solana_signer, and never merged into them."
            },
            "resolution": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "verified",
                    "probable",
                    "partial"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "How far the sources behind a resolved identity agreed; null when none was resolved."
            },
            "basis": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "theses",
                  "trades",
                  "identity",
                  "leaderboard"
                ]
              },
              "description": "Which stored tables named the person."
            }
          },
          "required": [
            "user_id",
            "handle",
            "name",
            "avatar_url",
            "x_handle",
            "x_profile",
            "profile_details",
            "solana_wallet",
            "evm_wallet",
            "solana_signer",
            "linked_wallets",
            "resolution",
            "basis"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "Null when no stored table names the person — a 200, never a 404."
    },
    "read_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
    }
  },
  "required": [
    "user",
    "read_at"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "user": {
      "type": "object",
      "properties": {
        "user_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "The person's stable id at the source, when a stored record or identity carries it. Store this, not the handle."
        },
        "handle": {
          "type": "string",
          "description": "Lower-cased, without the @. People rename — do not key on it."
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "The display name, when a record or the leaderboard carries one."
        },
        "avatar_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "The picture the leaderboard published, https only, or null."
        },
        "x_handle": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Reserved for independently verified X identity; currently null. A source-declared link is carried separately in x_profile."
        },
        "x_profile": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "handle": {
                  "type": "string",
                  "pattern": "^[A-Za-z0-9_]{1,15}$"
                },
                "source": {
                  "type": "string",
                  "const": "fomo"
                },
                "observed_at": {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                },
                "identity_verified": {
                  "type": "boolean",
                  "const": false
                }
              },
              "required": [
                "handle",
                "source",
                "observed_at",
                "identity_verified"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ],
          "description": "The X profile explicitly published by FOMO for this user id, with its observation time. Source-declared, not identity verification. Only explicitly public actors in the freshest trusted board snapshot qualify; older windows and directory socials are not fallbacks. Null after removal, absence, privacy restriction or expired evidence."
        },
        "profile_details": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "bio": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "banner_url": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "avatar_url": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "followers": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "following": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "source": {
                  "type": "string",
                  "const": "fomo"
                },
                "observed_at": {
                  "type": "object",
                  "properties": {
                    "bio": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "banner_url": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "avatar_url": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "followers": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "following": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "bio",
                    "banner_url",
                    "avatar_url",
                    "followers",
                    "following"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "bio",
                "banner_url",
                "avatar_url",
                "followers",
                "following",
                "source",
                "observed_at"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ],
          "description": "Public profile fields for an explicitly public native user in the one freshest trusted FOMO board snapshot. Supplemental snapshot coverage only: actors outside that snapshot are null and coverage can change as boards rotate. No older-window fallback. Each present field has its observation clock; absent fields are null without a clock, explicit source null retains its clock. Counts are source-reported, not a verified social graph. Evidence expires after 26 hours and may disappear under retention."
        },
        "solana_wallet": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Present only when FOMO's own trade page attested this wallet and its persisted capture proof remains trusted. The page names the person's user id beside the wallet that traded the position. Proof survives raw-capture expiry; revoked or unknown proof returns null. Never one resolved from a handle. This Solana address is FOMO's account address for the person, not an on-chain trading wallet: none of these addresses signs a FOMO swap on chain, and those checked hold no account and no token account. The Solana wallet that signs and holds is solana_signer."
        },
        "evm_wallet": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Present only when FOMO's own trade page attested this wallet and its persisted capture proof remains trusted. The page names the person's user id beside the wallet that traded the position. Proof survives raw-capture expiry; revoked or unknown proof returns null. Never one resolved from a handle."
        },
        "solana_signer": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "wallet": {
                  "type": "string",
                  "description": "The Solana wallet that signs this person's FOMO trades on chain — the trader's own signer beside FOMO's app wallet on each swap — and holds what they trade."
                },
                "method": {
                  "type": "string",
                  "enum": [
                    "chain_cooccurrence",
                    "cross_chain_deposit"
                  ],
                  "description": "chain_cooccurrence: a FOMO swap on chain matched exactly one trade the app showed for this person — the same token and side, within 5 seconds, the USD amount within 2 % or $0.25 (and cross-chain deposits may count beside them). cross_chain_deposit (1.7.0): every match is a deposit this wallet made to pay for a FOMO buy on another chain, matching exactly one EVM buy the app showed for this person within 10 seconds, the USD amount within 3 % or $0.50, and that buy exactly one deposit."
                },
                "matches": {
                  "type": "integer",
                  "minimum": 2,
                  "maximum": 9007199254740991,
                  "description": "Matches between this person and this wallet: swaps on chain and cross-chain deposits together. At least 2; the wallet holds at least 80 % of this person's matches, and this person at least 80 % of the wallet's."
                },
                "first_matched_at": {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
                  "description": "Block time of the first matched swap or deposit."
                },
                "last_matched_at": {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
                  "description": "Block time of the newest matched swap or deposit."
                },
                "sample_signature": {
                  "type": "string",
                  "description": "The newest matched swap's or deposit's transaction signature: look it up on chain to see this wallet sign it."
                }
              },
              "required": [
                "wallet",
                "method",
                "matches",
                "first_matched_at",
                "last_matched_at",
                "sample_signature"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ],
          "description": "INFERRED, NOT ATTESTED: the Solana wallet that signs this person's trades on chain, with the evidence behind the inference. FOMO publishes no map from a user to this wallet; it is read from FOMO's own app-signed swaps that coincide with the trades the app showed for this person, and from the deposits that pay for their buys on other chains, counted only from trusted collector captures after the provenance floor and only while the person is public. Null without at least 2 such matches holding 80 % both ways. A different kind of address from solana_wallet."
        },
        "linked_wallets": {
          "maxItems": 25,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "platform": {
                "type": "string",
                "enum": [
                  "pump",
                  "axiom",
                  "terminal"
                ],
                "description": "Whose public words name this wallet beside the X account: pump — a pump.fun account, served only where pump.fun's own payout board also names the account's numeric X id (its profile handle alone is self-declared); axiom — the caller of an Axiom call; terminal — another trading terminal's wallet profile or call."
              },
              "wallet": {
                "type": "string",
                "description": "The wallet as the platform names it: Solana exact, EVM lower-cased."
              },
              "chain_family": {
                "type": "string",
                "enum": [
                  "solana",
                  "evm"
                ],
                "description": "The address's family."
              },
              "via": {
                "type": "string",
                "const": "x_handle",
                "description": "x_handle: joined through the X username the platform names beside the wallet."
              },
              "level": {
                "type": "string",
                "const": "x_name_match",
                "description": "x_name_match: the handle and the display name both agree. The only level served; a handle alone links nothing."
              },
              "x_handle": {
                "type": "string",
                "pattern": "^[a-z0-9_]{1,15}$",
                "description": "The X username the platform names, lower-cased without the @ — equal to the person's handle."
              },
              "observed_at": {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
                "description": "The platform's newest observation of this claim."
              }
            },
            "required": [
              "platform",
              "wallet",
              "chain_family",
              "via",
              "level",
              "x_handle",
              "observed_at"
            ],
            "additionalProperties": false
          },
          "description": "Wallets other platforms publish for the X account this person logged in with, newest first, at most 25; empty when none qualifies. A platform's claim joined by X account, never a verification and never attested: the person's FOMO handle equals the X username the platform names beside the wallet, AND FOMO's display name for the person equals the X display name a platform shows for that username (compared case-folded, spaces collapsed; a display name equal to the handle never counts). Nothing for a handle two people show, nor for a wallet a platform also names for another X account, nor while the person is private. A different kind of address from solana_wallet, evm_wallet and solana_signer, and never merged into them."
        },
        "resolution": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "verified",
                "probable",
                "partial"
              ]
            },
            {
              "type": "null"
            }
          ],
          "description": "How far the sources behind a resolved identity agreed; null when none was resolved."
        },
        "basis": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "theses",
              "trades",
              "identity",
              "leaderboard"
            ]
          },
          "description": "Which stored tables named the person."
        }
      },
      "required": [
        "user_id",
        "handle",
        "name",
        "avatar_url",
        "x_handle",
        "x_profile",
        "profile_details",
        "solana_wallet",
        "evm_wallet",
        "solana_signer",
        "linked_wallets",
        "resolution",
        "basis"
      ],
      "additionalProperties": false
    },
    "resolved": {
      "type": "string",
      "enum": [
        "cached",
        "live"
      ],
      "description": "cached — a handle already resolved answered at once; live — this call's lookup resolved it."
    },
    "read_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
    }
  },
  "required": [
    "user",
    "resolved",
    "read_at"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "pending": {
      "type": "boolean",
      "const": true
    },
    "reason": {
      "type": "string",
      "enum": [
        "queued",
        "rate_limited",
        "unavailable",
        "no_preview"
      ],
      "description": "queued — the lookup is still running: ask again after retry_after_s and the running lookup answers. rate_limited — the key's resolve window is spent. unavailable — the lookup could not be made right now. no_preview — the lookup answered and could not resolve the handle; a prompt retry rarely helps."
    },
    "retryable": {
      "type": "boolean"
    },
    "retry_after_s": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ],
      "description": "Seconds to wait before asking again; null on no_preview."
    }
  },
  "required": [
    "pending",
    "reason",
    "retryable",
    "retry_after_s"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "handle": {
      "type": "string"
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "avatar_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "x_handle": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Reserved for independently verified X identity; currently null. A source-declared profile link does not establish identity or wallet ownership."
    },
    "x_profile": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "handle": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_]{1,15}$"
            },
            "source": {
              "type": "string",
              "const": "fomo"
            },
            "observed_at": {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
            },
            "identity_verified": {
              "type": "boolean",
              "const": false
            }
          },
          "required": [
            "handle",
            "source",
            "observed_at",
            "identity_verified"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "The X profile explicitly published by FOMO for this user id, with its observation time. Source-declared, not identity verification. Only explicitly public actors in the freshest trusted board snapshot qualify; older windows and directory socials are not fallbacks. Null after removal, absence, privacy restriction or expired evidence."
    },
    "followers": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ],
      "description": "Source-reported follower count from an eligible retained FOMO board; null without evidence. Its profile clock is separate from the PnL window clock."
    },
    "solana_wallet": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Present only when FOMO's own trade page attested this wallet and its persisted capture proof remains trusted. The page names the person's user id beside the wallet that traded the position. Proof survives raw-capture expiry; revoked or unknown proof returns null. Never one resolved from a handle. This Solana address is FOMO's account address for the person, not an on-chain trading wallet: none of these addresses signs a FOMO swap on chain, and those checked hold no account and no token account. The Solana wallet that signs and holds is solana_signer."
    },
    "evm_wallet": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Present only when FOMO's own trade page attested this wallet and its persisted capture proof remains trusted. The page names the person's user id beside the wallet that traded the position. Proof survives raw-capture expiry; revoked or unknown proof returns null. Never one resolved from a handle."
    },
    "solana_signer": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "wallet": {
              "type": "string",
              "description": "The Solana wallet that signs this person's FOMO trades on chain — the trader's own signer beside FOMO's app wallet on each swap — and holds what they trade."
            },
            "method": {
              "type": "string",
              "enum": [
                "chain_cooccurrence",
                "cross_chain_deposit"
              ],
              "description": "chain_cooccurrence: a FOMO swap on chain matched exactly one trade the app showed for this person — the same token and side, within 5 seconds, the USD amount within 2 % or $0.25 (and cross-chain deposits may count beside them). cross_chain_deposit (1.7.0): every match is a deposit this wallet made to pay for a FOMO buy on another chain, matching exactly one EVM buy the app showed for this person within 10 seconds, the USD amount within 3 % or $0.50, and that buy exactly one deposit."
            },
            "matches": {
              "type": "integer",
              "minimum": 2,
              "maximum": 9007199254740991,
              "description": "Matches between this person and this wallet: swaps on chain and cross-chain deposits together. At least 2; the wallet holds at least 80 % of this person's matches, and this person at least 80 % of the wallet's."
            },
            "first_matched_at": {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
              "description": "Block time of the first matched swap or deposit."
            },
            "last_matched_at": {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
              "description": "Block time of the newest matched swap or deposit."
            },
            "sample_signature": {
              "type": "string",
              "description": "The newest matched swap's or deposit's transaction signature: look it up on chain to see this wallet sign it."
            }
          },
          "required": [
            "wallet",
            "method",
            "matches",
            "first_matched_at",
            "last_matched_at",
            "sample_signature"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "INFERRED, NOT ATTESTED: the Solana wallet that signs this person's trades on chain, with the evidence behind the inference. FOMO publishes no map from a user to this wallet; it is read from FOMO's own app-signed swaps that coincide with the trades the app showed for this person, and from the deposits that pay for their buys on other chains, counted only from trusted collector captures after the provenance floor and only while the person is public. Null without at least 2 such matches holding 80 % both ways. A different kind of address from solana_wallet."
    },
    "updated_at": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
        },
        {
          "type": "null"
        }
      ],
      "description": "When the leaderboard figures were stored; null when no window carries one."
    },
    "windows": {
      "type": "object",
      "properties": {
        "24h": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "net_usd": {
                  "type": "number",
                  "description": "The leaderboard's PnL for the window, USD."
                },
                "return_pct": {
                  "type": "null",
                  "description": "Always null: the leaderboard publishes no percentage."
                },
                "volume_usd": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Currently null in every window: the captured volume total has no proven window-specific period."
                },
                "trades": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Currently null in every window: the captured trade total has no proven window-specific period."
                },
                "rank": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "The rank on the 7-day board; null on the other windows."
                }
              },
              "required": [
                "net_usd",
                "return_pct",
                "volume_usd",
                "trades",
                "rank"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "7d": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "net_usd": {
                  "type": "number",
                  "description": "The leaderboard's PnL for the window, USD."
                },
                "return_pct": {
                  "type": "null",
                  "description": "Always null: the leaderboard publishes no percentage."
                },
                "volume_usd": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Currently null in every window: the captured volume total has no proven window-specific period."
                },
                "trades": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Currently null in every window: the captured trade total has no proven window-specific period."
                },
                "rank": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "The rank on the 7-day board; null on the other windows."
                }
              },
              "required": [
                "net_usd",
                "return_pct",
                "volume_usd",
                "trades",
                "rank"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "30d": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "net_usd": {
                  "type": "number",
                  "description": "The leaderboard's PnL for the window, USD."
                },
                "return_pct": {
                  "type": "null",
                  "description": "Always null: the leaderboard publishes no percentage."
                },
                "volume_usd": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Currently null in every window: the captured volume total has no proven window-specific period."
                },
                "trades": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Currently null in every window: the captured trade total has no proven window-specific period."
                },
                "rank": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "The rank on the 7-day board; null on the other windows."
                }
              },
              "required": [
                "net_usd",
                "return_pct",
                "volume_usd",
                "trades",
                "rank"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "all": {
          "type": "null",
          "description": "Currently null: this reader does not project a qualified all-time window."
        }
      },
      "required": [
        "24h",
        "7d",
        "30d",
        "all"
      ],
      "additionalProperties": false,
      "description": "One entry per window, all four keys present. A window is null when the board does not carry it, or the trader is off today's board."
    }
  },
  "required": [
    "handle",
    "name",
    "avatar_url",
    "x_handle",
    "x_profile",
    "followers",
    "solana_wallet",
    "evm_wallet",
    "solana_signer",
    "updated_at",
    "windows"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Entries returned: the handles a stored table holds."
    },
    "missing": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Requested handles no stored table holds, lower-cased, without the @."
    },
    "entries": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "handle": {
            "type": "string"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "avatar_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "x_handle": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Reserved for independently verified X identity; currently null. A source-declared profile link does not establish identity or wallet ownership."
          },
          "x_profile": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "handle": {
                    "type": "string",
                    "pattern": "^[A-Za-z0-9_]{1,15}$"
                  },
                  "source": {
                    "type": "string",
                    "const": "fomo"
                  },
                  "observed_at": {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
                  },
                  "identity_verified": {
                    "type": "boolean",
                    "const": false
                  }
                },
                "required": [
                  "handle",
                  "source",
                  "observed_at",
                  "identity_verified"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ],
            "description": "The X profile explicitly published by FOMO for this user id, with its observation time. Source-declared, not identity verification. Only explicitly public actors in the freshest trusted board snapshot qualify; older windows and directory socials are not fallbacks. Null after removal, absence, privacy restriction or expired evidence."
          },
          "followers": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "Source-reported follower count from an eligible retained FOMO board; null without evidence. Its profile clock is separate from the PnL window clock."
          },
          "solana_wallet": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Present only when FOMO's own trade page attested this wallet and its persisted capture proof remains trusted. The page names the person's user id beside the wallet that traded the position. Proof survives raw-capture expiry; revoked or unknown proof returns null. Never one resolved from a handle. This Solana address is FOMO's account address for the person, not an on-chain trading wallet: none of these addresses signs a FOMO swap on chain, and those checked hold no account and no token account. The Solana wallet that signs and holds is solana_signer."
          },
          "evm_wallet": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Present only when FOMO's own trade page attested this wallet and its persisted capture proof remains trusted. The page names the person's user id beside the wallet that traded the position. Proof survives raw-capture expiry; revoked or unknown proof returns null. Never one resolved from a handle."
          },
          "solana_signer": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "wallet": {
                    "type": "string",
                    "description": "The Solana wallet that signs this person's FOMO trades on chain — the trader's own signer beside FOMO's app wallet on each swap — and holds what they trade."
                  },
                  "method": {
                    "type": "string",
                    "enum": [
                      "chain_cooccurrence",
                      "cross_chain_deposit"
                    ],
                    "description": "chain_cooccurrence: a FOMO swap on chain matched exactly one trade the app showed for this person — the same token and side, within 5 seconds, the USD amount within 2 % or $0.25 (and cross-chain deposits may count beside them). cross_chain_deposit (1.7.0): every match is a deposit this wallet made to pay for a FOMO buy on another chain, matching exactly one EVM buy the app showed for this person within 10 seconds, the USD amount within 3 % or $0.50, and that buy exactly one deposit."
                  },
                  "matches": {
                    "type": "integer",
                    "minimum": 2,
                    "maximum": 9007199254740991,
                    "description": "Matches between this person and this wallet: swaps on chain and cross-chain deposits together. At least 2; the wallet holds at least 80 % of this person's matches, and this person at least 80 % of the wallet's."
                  },
                  "first_matched_at": {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
                    "description": "Block time of the first matched swap or deposit."
                  },
                  "last_matched_at": {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
                    "description": "Block time of the newest matched swap or deposit."
                  },
                  "sample_signature": {
                    "type": "string",
                    "description": "The newest matched swap's or deposit's transaction signature: look it up on chain to see this wallet sign it."
                  }
                },
                "required": [
                  "wallet",
                  "method",
                  "matches",
                  "first_matched_at",
                  "last_matched_at",
                  "sample_signature"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ],
            "description": "INFERRED, NOT ATTESTED: the Solana wallet that signs this person's trades on chain, with the evidence behind the inference. FOMO publishes no map from a user to this wallet; it is read from FOMO's own app-signed swaps that coincide with the trades the app showed for this person, and from the deposits that pay for their buys on other chains, counted only from trusted collector captures after the provenance floor and only while the person is public. Null without at least 2 such matches holding 80 % both ways. A different kind of address from solana_wallet."
          },
          "updated_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
              },
              {
                "type": "null"
              }
            ],
            "description": "When the leaderboard figures were stored; null when no window carries one."
          },
          "windows": {
            "type": "object",
            "properties": {
              "24h": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "net_usd": {
                        "type": "number",
                        "description": "The leaderboard's PnL for the window, USD."
                      },
                      "return_pct": {
                        "type": "null",
                        "description": "Always null: the leaderboard publishes no percentage."
                      },
                      "volume_usd": {
                        "anyOf": [
                          {
                            "type": "number"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Currently null in every window: the captured volume total has no proven window-specific period."
                      },
                      "trades": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Currently null in every window: the captured trade total has no proven window-specific period."
                      },
                      "rank": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The rank on the 7-day board; null on the other windows."
                      }
                    },
                    "required": [
                      "net_usd",
                      "return_pct",
                      "volume_usd",
                      "trades",
                      "rank"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "7d": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "net_usd": {
                        "type": "number",
                        "description": "The leaderboard's PnL for the window, USD."
                      },
                      "return_pct": {
                        "type": "null",
                        "description": "Always null: the leaderboard publishes no percentage."
                      },
                      "volume_usd": {
                        "anyOf": [
                          {
                            "type": "number"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Currently null in every window: the captured volume total has no proven window-specific period."
                      },
                      "trades": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Currently null in every window: the captured trade total has no proven window-specific period."
                      },
                      "rank": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The rank on the 7-day board; null on the other windows."
                      }
                    },
                    "required": [
                      "net_usd",
                      "return_pct",
                      "volume_usd",
                      "trades",
                      "rank"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "30d": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "net_usd": {
                        "type": "number",
                        "description": "The leaderboard's PnL for the window, USD."
                      },
                      "return_pct": {
                        "type": "null",
                        "description": "Always null: the leaderboard publishes no percentage."
                      },
                      "volume_usd": {
                        "anyOf": [
                          {
                            "type": "number"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Currently null in every window: the captured volume total has no proven window-specific period."
                      },
                      "trades": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Currently null in every window: the captured trade total has no proven window-specific period."
                      },
                      "rank": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The rank on the 7-day board; null on the other windows."
                      }
                    },
                    "required": [
                      "net_usd",
                      "return_pct",
                      "volume_usd",
                      "trades",
                      "rank"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "all": {
                "type": "null",
                "description": "Currently null: this reader does not project a qualified all-time window."
              }
            },
            "required": [
              "24h",
              "7d",
              "30d",
              "all"
            ],
            "additionalProperties": false,
            "description": "One entry per window, all four keys present. A window is null when the board does not carry it, or the trader is off today's board."
          }
        },
        "required": [
          "handle",
          "name",
          "avatar_url",
          "x_handle",
          "x_profile",
          "followers",
          "solana_wallet",
          "evm_wallet",
          "solana_signer",
          "updated_at",
          "windows"
        ],
        "additionalProperties": false
      },
      "description": "In the order requested."
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "How these figures differ from a cash-flow ledger."
    },
    "read_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
    }
  },
  "required": [
    "count",
    "missing",
    "entries",
    "notes",
    "read_at"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "key": {
      "type": "object",
      "properties": {
        "prefix": {
          "type": "string",
          "description": "The key's display prefix — never the key."
        },
        "plan": {
          "type": "string",
          "description": "The data plan the key is sold on."
        }
      },
      "required": [
        "prefix",
        "plan"
      ],
      "additionalProperties": false
    },
    "allowance": {
      "type": "object",
      "properties": {
        "requests_per_minute": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "requests_per_day": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "used_today": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991,
          "description": "Requests counted today, this one included."
        },
        "remaining_today": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "resets_at": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
          "description": "The next UTC midnight."
        },
        "streams": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991,
          "description": "Push sockets the key may hold open at once, across every push door."
        }
      },
      "required": [
        "requests_per_minute",
        "requests_per_day",
        "used_today",
        "remaining_today",
        "resets_at",
        "streams"
      ],
      "additionalProperties": false
    },
    "read_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
    }
  },
  "required": [
    "key",
    "allowance",
    "read_at"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string"
    },
    "username": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "profile_image": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "x_username": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The X handle pump.fun shows for the account — the platform's word, not a verification."
    },
    "followers": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "following": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ],
      "description": "Accounts this one follows on pump.fun, from the account's last stored profile read."
    },
    "bio": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The profile's own bio, verbatim, from the last stored profile read."
    },
    "is_pump_user": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "description": "False is pump.fun's answer for a wallet that traded without creating an account."
    },
    "is_verified": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "description": "pump.fun's own verified badge on the account, as pump.fun showed it; null when no stored observation carries one. The platform's word, not a verification of the X account or of wallet ownership."
    },
    "group_badges": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "role": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "id",
          "name",
          "role"
        ],
        "additionalProperties": false
      },
      "description": "The squads pump.fun names on the profile: the squad's id, its name and the account's role in it. Empty when it names none or no profile was read."
    },
    "canonical_svm_wallet": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The account's Solana wallet as pump.fun links it."
    },
    "canonical_evm_wallet": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The account's EVM wallet as pump.fun links it to the same account."
    },
    "x_user_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "X's numeric user id, as pump.fun's public payout board publishes it for the account — rename-stable, and the platform's word, not a verification."
    }
  },
  "required": [
    "wallet",
    "username",
    "profile_image",
    "x_username",
    "followers",
    "following",
    "bio",
    "is_pump_user",
    "is_verified",
    "group_badges",
    "canonical_svm_wallet",
    "canonical_evm_wallet",
    "x_user_id"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "user": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "wallet": {
              "type": "string"
            },
            "username": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "profile_image": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "x_username": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "The X handle pump.fun shows for the account — the platform's word, not a verification."
            },
            "followers": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            },
            "following": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ],
              "description": "Accounts this one follows on pump.fun, from the account's last stored profile read."
            },
            "bio": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "The profile's own bio, verbatim, from the last stored profile read."
            },
            "is_pump_user": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "description": "False is pump.fun's answer for a wallet that traded without creating an account."
            },
            "is_verified": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "description": "pump.fun's own verified badge on the account, as pump.fun showed it; null when no stored observation carries one. The platform's word, not a verification of the X account or of wallet ownership."
            },
            "group_badges": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "role": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "id",
                  "name",
                  "role"
                ],
                "additionalProperties": false
              },
              "description": "The squads pump.fun names on the profile: the squad's id, its name and the account's role in it. Empty when it names none or no profile was read."
            },
            "canonical_svm_wallet": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "The account's Solana wallet as pump.fun links it."
            },
            "canonical_evm_wallet": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "The account's EVM wallet as pump.fun links it to the same account."
            },
            "x_user_id": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "X's numeric user id, as pump.fun's public payout board publishes it for the account — rename-stable, and the platform's word, not a verification."
            }
          },
          "required": [
            "wallet",
            "username",
            "profile_image",
            "x_username",
            "followers",
            "following",
            "bio",
            "is_pump_user",
            "is_verified",
            "group_badges",
            "canonical_svm_wallet",
            "canonical_evm_wallet",
            "x_user_id"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "Null when no stored record holds the wallet."
    },
    "read_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
    }
  },
  "required": [
    "user",
    "read_at"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "callout_id": {
      "type": "string",
      "description": "Dedupe on it; send the page's last as ?before= to continue."
    },
    "wallet": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The caller — on pump.fun the wallet is the identity."
    },
    "user_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The caller's pump.fun username when they published one."
    },
    "x_username": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The X handle pump.fun showed with the callout, else the caller's stored profile's; the platform's word, not a verification."
    },
    "profile_image": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Stored caller image joined by the exact source wallet, else the image pump.fun showed with the callout; HTTPS only, null without one. Names and X handles are never join keys."
    },
    "is_verified": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "description": "pump.fun's own verified badge on the account, as pump.fun showed it; null when no stored observation carries one. The platform's word, not a verification of the X account or of wallet ownership."
    },
    "coin_mint": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The coin's address: a Solana mint exact, an EVM address lower-cased."
    },
    "chain": {
      "type": "string",
      "description": "The coin's chain, in this API's chain words (solana, ethereum, base, bsc, robinhood, …)."
    },
    "coin_symbol": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "coin_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "text": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The caller's own words; null when they wrote none."
    },
    "media_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The media the caller attached to the callout, HTTPS only; null without one."
    },
    "called_out_at_mcap": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "Market cap (USD) when the callout was posted, as pump.fun read it."
    },
    "multiple": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "Price move since the callout, ×, when stored."
    },
    "max_multiplier": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "The peak move since the callout, ×, when stored."
    },
    "occurred_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
    }
  },
  "required": [
    "callout_id",
    "wallet",
    "user_name",
    "x_username",
    "profile_image",
    "is_verified",
    "coin_mint",
    "chain",
    "coin_symbol",
    "coin_name",
    "text",
    "media_url",
    "called_out_at_mcap",
    "multiple",
    "max_multiplier",
    "occurred_at"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "has_more": {
      "type": "boolean"
    },
    "next_before": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The page's oldest callout_id while has_more; null on the last page. 25 to a page."
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "callout_id": {
            "type": "string",
            "description": "Dedupe on it; send the page's last as ?before= to continue."
          },
          "wallet": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The caller — on pump.fun the wallet is the identity."
          },
          "user_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The caller's pump.fun username when they published one."
          },
          "x_username": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The X handle pump.fun showed with the callout, else the caller's stored profile's; the platform's word, not a verification."
          },
          "profile_image": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Stored caller image joined by the exact source wallet, else the image pump.fun showed with the callout; HTTPS only, null without one. Names and X handles are never join keys."
          },
          "is_verified": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "pump.fun's own verified badge on the account, as pump.fun showed it; null when no stored observation carries one. The platform's word, not a verification of the X account or of wallet ownership."
          },
          "coin_mint": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The coin's address: a Solana mint exact, an EVM address lower-cased."
          },
          "chain": {
            "type": "string",
            "description": "The coin's chain, in this API's chain words (solana, ethereum, base, bsc, robinhood, …)."
          },
          "coin_symbol": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "coin_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The caller's own words; null when they wrote none."
          },
          "media_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The media the caller attached to the callout, HTTPS only; null without one."
          },
          "called_out_at_mcap": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Market cap (USD) when the callout was posted, as pump.fun read it."
          },
          "multiple": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Price move since the callout, ×, when stored."
          },
          "max_multiplier": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "The peak move since the callout, ×, when stored."
          },
          "occurred_at": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
          }
        },
        "required": [
          "callout_id",
          "wallet",
          "user_name",
          "x_username",
          "profile_image",
          "is_verified",
          "coin_mint",
          "chain",
          "coin_symbol",
          "coin_name",
          "text",
          "media_url",
          "called_out_at_mcap",
          "multiple",
          "max_multiplier",
          "occurred_at"
        ],
        "additionalProperties": false
      }
    },
    "read_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
    }
  },
  "required": [
    "count",
    "has_more",
    "next_before",
    "items",
    "read_at"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "has_more": {
      "type": "boolean"
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "callout_id": {
            "type": "string",
            "description": "Dedupe on it; send the page's last as ?before= to continue."
          },
          "wallet": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The caller — on pump.fun the wallet is the identity."
          },
          "user_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The caller's pump.fun username when they published one."
          },
          "x_username": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The X handle pump.fun showed with the callout, else the caller's stored profile's; the platform's word, not a verification."
          },
          "profile_image": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Stored caller image joined by the exact source wallet, else the image pump.fun showed with the callout; HTTPS only, null without one. Names and X handles are never join keys."
          },
          "is_verified": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "pump.fun's own verified badge on the account, as pump.fun showed it; null when no stored observation carries one. The platform's word, not a verification of the X account or of wallet ownership."
          },
          "coin_mint": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The coin's address: a Solana mint exact, an EVM address lower-cased."
          },
          "chain": {
            "type": "string",
            "description": "The coin's chain, in this API's chain words (solana, ethereum, base, bsc, robinhood, …)."
          },
          "coin_symbol": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "coin_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The caller's own words; null when they wrote none."
          },
          "media_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The media the caller attached to the callout, HTTPS only; null without one."
          },
          "called_out_at_mcap": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Market cap (USD) when the callout was posted, as pump.fun read it."
          },
          "multiple": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Price move since the callout, ×, when stored."
          },
          "max_multiplier": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "The peak move since the callout, ×, when stored."
          },
          "occurred_at": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
          }
        },
        "required": [
          "callout_id",
          "wallet",
          "user_name",
          "x_username",
          "profile_image",
          "is_verified",
          "coin_mint",
          "chain",
          "coin_symbol",
          "coin_name",
          "text",
          "media_url",
          "called_out_at_mcap",
          "multiple",
          "max_multiplier",
          "occurred_at"
        ],
        "additionalProperties": false
      }
    },
    "read_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
    },
    "changes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "cursor": {
            "type": "string"
          },
          "revision": {
            "type": "string"
          },
          "source_ts": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
              },
              {
                "type": "null"
              }
            ]
          },
          "captured_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
              },
              {
                "type": "null"
              }
            ]
          },
          "received_at": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
          },
          "ingested_at": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
          }
        },
        "required": [
          "cursor",
          "revision",
          "source_ts",
          "captured_at",
          "received_at",
          "ingested_at"
        ],
        "additionalProperties": false
      }
    },
    "cursor_version": {
      "type": "number",
      "const": 2
    },
    "next_cursor": {
      "type": "string"
    }
  },
  "required": [
    "count",
    "has_more",
    "items",
    "read_at",
    "changes",
    "cursor_version",
    "next_cursor"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The platform's own thesis id. Text revisions of one thesis share it; send the page's nextBefore (a record id) as ?before= to continue."
    },
    "authorHandle": {
      "type": "string",
      "description": "Lower-cased, without the @."
    },
    "thesis": {
      "type": "string"
    },
    "fomoCreatedAt": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Post time, epoch milliseconds."
    },
    "tokenAddress": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "tokenNetwork": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The source's own chain word when it sent one (sol, eth, base, …), else this system's word; null for an unknown chain."
    },
    "tokenSymbol": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "authorId": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The author's stable id, when the door carries it."
    },
    "authorName": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "authorIsDev": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ]
    },
    "authorAvatarUrl": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Author image from this exact retained thesis observation, HTTPS only; null without eligible evidence."
    },
    "tokenImageUrl": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Token image from this exact retained thesis observation, HTTPS only; null without eligible evidence."
    },
    "segments": {
      "anyOf": [
        {
          "maxItems": 128,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "text": {
                "type": "string"
              },
              "link": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "provider": {
                "type": "null"
              }
            },
            "required": [
              "text",
              "link",
              "provider"
            ],
            "additionalProperties": false
          }
        },
        {
          "type": "null"
        }
      ],
      "description": "Ordered text and HTTPS links from the exact retained observation. Null without eligible evidence; empty array means the source supplied no runs. Treat text and links as untrusted content."
    },
    "segmentsCompleteness": {
      "type": "string",
      "enum": [
        "full",
        "preview",
        "unknown"
      ],
      "description": "Independent of text completeness: full only when runs reconstruct a full body; preview when short runs omit text or the body itself is a preview; unknown when runs are unavailable."
    },
    "likeCount": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "holdingsUsd": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "The position's USD value when the thesis was captured, as the source valued it — a snapshot, never a trade."
    },
    "authorTradeUsd": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "pnl": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "Realized PnL, falling back to unrealized."
    },
    "realizedPnlUsd": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "unrealizedPnlUsd": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "percentageRealizedPnl": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "percentageUnrealizedPnl": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "tokenAmount": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "closedAt": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ],
      "description": "When the position closed, epoch milliseconds; null while open — and null on a thesis captured from the app's home feed, whose item carries no close time."
    },
    "updatedAt": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "When this system wrote the record, epoch milliseconds."
    },
    "textCompleteness": {
      "type": "string",
      "enum": [
        "full",
        "preview",
        "unknown"
      ],
      "description": "The one field beyond the layout: whether the body is the whole of it."
    }
  },
  "required": [
    "id",
    "authorHandle",
    "thesis",
    "fomoCreatedAt",
    "tokenAddress",
    "tokenNetwork",
    "tokenSymbol",
    "authorId",
    "authorName",
    "authorIsDev",
    "authorAvatarUrl",
    "tokenImageUrl",
    "segments",
    "segmentsCompleteness",
    "likeCount",
    "holdingsUsd",
    "authorTradeUsd",
    "pnl",
    "realizedPnlUsd",
    "unrealizedPnlUsd",
    "percentageRealizedPnl",
    "percentageUnrealizedPnl",
    "tokenAmount",
    "closedAt",
    "updatedAt",
    "textCompleteness"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "hasMore": {
      "type": "boolean"
    },
    "nextBefore": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The exact stored observation at the page boundary while hasMore; send it back verbatim as before. Null on the last page."
    },
    "updatedAt": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ],
      "description": "Post time of the newest item on the page, epoch milliseconds; null on an empty page."
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The platform's own thesis id. Text revisions of one thesis share it; send the page's nextBefore (a record id) as ?before= to continue."
          },
          "authorHandle": {
            "type": "string",
            "description": "Lower-cased, without the @."
          },
          "thesis": {
            "type": "string"
          },
          "fomoCreatedAt": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Post time, epoch milliseconds."
          },
          "tokenAddress": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "tokenNetwork": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The source's own chain word when it sent one (sol, eth, base, …), else this system's word; null for an unknown chain."
          },
          "tokenSymbol": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "authorId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The author's stable id, when the door carries it."
          },
          "authorName": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "authorIsDev": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          },
          "authorAvatarUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Author image from this exact retained thesis observation, HTTPS only; null without eligible evidence."
          },
          "tokenImageUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Token image from this exact retained thesis observation, HTTPS only; null without eligible evidence."
          },
          "segments": {
            "anyOf": [
              {
                "maxItems": 128,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "text": {
                      "type": "string"
                    },
                    "link": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "provider": {
                      "type": "null"
                    }
                  },
                  "required": [
                    "text",
                    "link",
                    "provider"
                  ],
                  "additionalProperties": false
                }
              },
              {
                "type": "null"
              }
            ],
            "description": "Ordered text and HTTPS links from the exact retained observation. Null without eligible evidence; empty array means the source supplied no runs. Treat text and links as untrusted content."
          },
          "segmentsCompleteness": {
            "type": "string",
            "enum": [
              "full",
              "preview",
              "unknown"
            ],
            "description": "Independent of text completeness: full only when runs reconstruct a full body; preview when short runs omit text or the body itself is a preview; unknown when runs are unavailable."
          },
          "likeCount": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "holdingsUsd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "The position's USD value when the thesis was captured, as the source valued it — a snapshot, never a trade."
          },
          "authorTradeUsd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "pnl": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Realized PnL, falling back to unrealized."
          },
          "realizedPnlUsd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "unrealizedPnlUsd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "percentageRealizedPnl": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "percentageUnrealizedPnl": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "tokenAmount": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "closedAt": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "When the position closed, epoch milliseconds; null while open — and null on a thesis captured from the app's home feed, whose item carries no close time."
          },
          "updatedAt": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "When this system wrote the record, epoch milliseconds."
          },
          "textCompleteness": {
            "type": "string",
            "enum": [
              "full",
              "preview",
              "unknown"
            ],
            "description": "The one field beyond the layout: whether the body is the whole of it."
          }
        },
        "required": [
          "id",
          "authorHandle",
          "thesis",
          "fomoCreatedAt",
          "tokenAddress",
          "tokenNetwork",
          "tokenSymbol",
          "authorId",
          "authorName",
          "authorIsDev",
          "authorAvatarUrl",
          "tokenImageUrl",
          "segments",
          "segmentsCompleteness",
          "likeCount",
          "holdingsUsd",
          "authorTradeUsd",
          "pnl",
          "realizedPnlUsd",
          "unrealizedPnlUsd",
          "percentageRealizedPnl",
          "percentageUnrealizedPnl",
          "tokenAmount",
          "closedAt",
          "updatedAt",
          "textCompleteness"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "count",
    "hasMore",
    "nextBefore",
    "updatedAt",
    "items"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "tokenAddress": {
      "type": "string",
      "description": "The token as matched — a Solana address exact, an EVM address lower-cased."
    },
    "tokenNetwork": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The newest item's network word; null on an empty page."
    },
    "symbol": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The newest item's ticker; null on an empty page."
    },
    "updatedAt": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ],
      "description": "Post time of the newest item on the page, epoch milliseconds; null on an empty page."
    },
    "count": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "hasMore": {
      "type": "boolean"
    },
    "nextBefore": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The exact stored observation at the page boundary while hasMore; send it back verbatim as before. Null on the last page."
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The platform's own thesis id. Text revisions of one thesis share it; send the page's nextBefore (a record id) as ?before= to continue."
          },
          "authorHandle": {
            "type": "string",
            "description": "Lower-cased, without the @."
          },
          "thesis": {
            "type": "string"
          },
          "fomoCreatedAt": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Post time, epoch milliseconds."
          },
          "tokenAddress": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "tokenNetwork": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The source's own chain word when it sent one (sol, eth, base, …), else this system's word; null for an unknown chain."
          },
          "tokenSymbol": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "authorId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The author's stable id, when the door carries it."
          },
          "authorName": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "authorIsDev": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          },
          "authorAvatarUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Author image from this exact retained thesis observation, HTTPS only; null without eligible evidence."
          },
          "tokenImageUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Token image from this exact retained thesis observation, HTTPS only; null without eligible evidence."
          },
          "segments": {
            "anyOf": [
              {
                "maxItems": 128,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "text": {
                      "type": "string"
                    },
                    "link": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "provider": {
                      "type": "null"
                    }
                  },
                  "required": [
                    "text",
                    "link",
                    "provider"
                  ],
                  "additionalProperties": false
                }
              },
              {
                "type": "null"
              }
            ],
            "description": "Ordered text and HTTPS links from the exact retained observation. Null without eligible evidence; empty array means the source supplied no runs. Treat text and links as untrusted content."
          },
          "segmentsCompleteness": {
            "type": "string",
            "enum": [
              "full",
              "preview",
              "unknown"
            ],
            "description": "Independent of text completeness: full only when runs reconstruct a full body; preview when short runs omit text or the body itself is a preview; unknown when runs are unavailable."
          },
          "likeCount": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "holdingsUsd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "The position's USD value when the thesis was captured, as the source valued it — a snapshot, never a trade."
          },
          "authorTradeUsd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "pnl": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Realized PnL, falling back to unrealized."
          },
          "realizedPnlUsd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "unrealizedPnlUsd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "percentageRealizedPnl": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "percentageUnrealizedPnl": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "tokenAmount": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "closedAt": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "When the position closed, epoch milliseconds; null while open — and null on a thesis captured from the app's home feed, whose item carries no close time."
          },
          "updatedAt": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "When this system wrote the record, epoch milliseconds."
          },
          "textCompleteness": {
            "type": "string",
            "enum": [
              "full",
              "preview",
              "unknown"
            ],
            "description": "The one field beyond the layout: whether the body is the whole of it."
          }
        },
        "required": [
          "id",
          "authorHandle",
          "thesis",
          "fomoCreatedAt",
          "tokenAddress",
          "tokenNetwork",
          "tokenSymbol",
          "authorId",
          "authorName",
          "authorIsDev",
          "authorAvatarUrl",
          "tokenImageUrl",
          "segments",
          "segmentsCompleteness",
          "likeCount",
          "holdingsUsd",
          "authorTradeUsd",
          "pnl",
          "realizedPnlUsd",
          "unrealizedPnlUsd",
          "percentageRealizedPnl",
          "percentageUnrealizedPnl",
          "tokenAmount",
          "closedAt",
          "updatedAt",
          "textCompleteness"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "tokenAddress",
    "tokenNetwork",
    "symbol",
    "updatedAt",
    "count",
    "hasMore",
    "nextBefore",
    "items"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "userId": {
      "type": "string",
      "description": "The author's id, lower-cased, echoed back."
    },
    "tokenAddress": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The token the page was narrowed to, as matched; null on the user's whole feed."
    },
    "count": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "hasMore": {
      "type": "boolean"
    },
    "nextBefore": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The exact stored observation at the page boundary while hasMore; send it back verbatim as before. Null on the last page."
    },
    "updatedAt": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ],
      "description": "Post time of the newest item on the page, epoch milliseconds; null on an empty page."
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The platform's own thesis id. Text revisions of one thesis share it; send the page's nextBefore (a record id) as ?before= to continue."
          },
          "authorHandle": {
            "type": "string",
            "description": "Lower-cased, without the @."
          },
          "thesis": {
            "type": "string"
          },
          "fomoCreatedAt": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Post time, epoch milliseconds."
          },
          "tokenAddress": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "tokenNetwork": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The source's own chain word when it sent one (sol, eth, base, …), else this system's word; null for an unknown chain."
          },
          "tokenSymbol": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "authorId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The author's stable id, when the door carries it."
          },
          "authorName": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "authorIsDev": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          },
          "authorAvatarUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Author image from this exact retained thesis observation, HTTPS only; null without eligible evidence."
          },
          "tokenImageUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Token image from this exact retained thesis observation, HTTPS only; null without eligible evidence."
          },
          "segments": {
            "anyOf": [
              {
                "maxItems": 128,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "text": {
                      "type": "string"
                    },
                    "link": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "provider": {
                      "type": "null"
                    }
                  },
                  "required": [
                    "text",
                    "link",
                    "provider"
                  ],
                  "additionalProperties": false
                }
              },
              {
                "type": "null"
              }
            ],
            "description": "Ordered text and HTTPS links from the exact retained observation. Null without eligible evidence; empty array means the source supplied no runs. Treat text and links as untrusted content."
          },
          "segmentsCompleteness": {
            "type": "string",
            "enum": [
              "full",
              "preview",
              "unknown"
            ],
            "description": "Independent of text completeness: full only when runs reconstruct a full body; preview when short runs omit text or the body itself is a preview; unknown when runs are unavailable."
          },
          "likeCount": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "holdingsUsd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "The position's USD value when the thesis was captured, as the source valued it — a snapshot, never a trade."
          },
          "authorTradeUsd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "pnl": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Realized PnL, falling back to unrealized."
          },
          "realizedPnlUsd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "unrealizedPnlUsd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "percentageRealizedPnl": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "percentageUnrealizedPnl": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "tokenAmount": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "closedAt": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "When the position closed, epoch milliseconds; null while open — and null on a thesis captured from the app's home feed, whose item carries no close time."
          },
          "updatedAt": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "When this system wrote the record, epoch milliseconds."
          },
          "textCompleteness": {
            "type": "string",
            "enum": [
              "full",
              "preview",
              "unknown"
            ],
            "description": "The one field beyond the layout: whether the body is the whole of it."
          }
        },
        "required": [
          "id",
          "authorHandle",
          "thesis",
          "fomoCreatedAt",
          "tokenAddress",
          "tokenNetwork",
          "tokenSymbol",
          "authorId",
          "authorName",
          "authorIsDev",
          "authorAvatarUrl",
          "tokenImageUrl",
          "segments",
          "segmentsCompleteness",
          "likeCount",
          "holdingsUsd",
          "authorTradeUsd",
          "pnl",
          "realizedPnlUsd",
          "unrealizedPnlUsd",
          "percentageRealizedPnl",
          "percentageUnrealizedPnl",
          "tokenAmount",
          "closedAt",
          "updatedAt",
          "textCompleteness"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "userId",
    "tokenAddress",
    "count",
    "hasMore",
    "nextBefore",
    "updatedAt",
    "items"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The person's stable id at the source; null when only the relay doors named them."
    },
    "handle": {
      "type": "string"
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "bio": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Source-published bio from an eligible retained FOMO board observation; null when unavailable or explicitly cleared."
    },
    "banner": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Source-published HTTPS banner from an eligible retained FOMO board observation; null when unavailable or cleared."
    },
    "profilePicture": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "HTTPS avatar from the eligible current public source snapshot, or null. No older directory-image fallback when evidence is missing, cleared or privacy-suppressed."
    },
    "twitter": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Source-declared X profile URL published by FOMO for this user id; null without an eligible public observation. This field is not identity or wallet-ownership verification."
    },
    "solanaAddress": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Present only when FOMO's own trade page attested this wallet and its persisted capture proof remains trusted. The page names the person's user id beside the wallet that traded the position. Proof survives raw-capture expiry; revoked or unknown proof returns null. Never one resolved from a handle. This Solana address is FOMO's account address for the person, not an on-chain trading wallet: none of these addresses signs a FOMO swap on chain, and those checked hold no account and no token account. The Solana wallet that signs and holds is solana_signer."
    },
    "evmAddress": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Present only when FOMO's own trade page attested this wallet and its persisted capture proof remains trusted. The page names the person's user id beside the wallet that traded the position. Proof survives raw-capture expiry; revoked or unknown proof returns null. Never one resolved from a handle."
    },
    "solanaSignerAddress": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Added: the Solana wallet that signs this person's trades on chain: the native lookup's solana_signer.wallet — INFERRED from FOMO's own app-signed swaps that coincide with the trades the app showed for the person (at least 2 matches holding 80 % both ways; the native lookup carries the evidence), never attested. Null without a served link."
    },
    "linkedWallets": {
      "maxItems": 25,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "platform": {
            "type": "string",
            "enum": [
              "pump",
              "axiom",
              "terminal"
            ],
            "description": "Whose public words name this wallet beside the X account: pump — a pump.fun account, served only where pump.fun's own payout board also names the account's numeric X id (its profile handle alone is self-declared); axiom — the caller of an Axiom call; terminal — another trading terminal's wallet profile or call."
          },
          "wallet": {
            "type": "string"
          },
          "chainFamily": {
            "type": "string",
            "enum": [
              "solana",
              "evm"
            ]
          },
          "via": {
            "type": "string",
            "const": "x_handle"
          },
          "level": {
            "type": "string",
            "const": "x_name_match"
          },
          "xHandle": {
            "type": "string",
            "pattern": "^[a-z0-9_]{1,15}$"
          },
          "observedAt": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "The platform's newest observation of this claim, epoch milliseconds."
          }
        },
        "required": [
          "platform",
          "wallet",
          "chainFamily",
          "via",
          "level",
          "xHandle",
          "observedAt"
        ],
        "additionalProperties": false
      },
      "description": "Added: the native lookup's linked_wallets in the layout's names. A platform's claim joined by X account, never a verification and never attested: the person's FOMO handle equals the X username the platform names beside the wallet, AND FOMO's display name for the person equals the X display name a platform shows for that username (compared case-folded, spaces collapsed; a display name equal to the handle never counts). Nothing for a handle two people show, nor for a wallet a platform also names for another X account, nor while the person is private. A different kind of address from solana_wallet, evm_wallet and solana_signer, and never merged into them."
    }
  },
  "required": [
    "id",
    "handle",
    "name",
    "bio",
    "banner",
    "profilePicture",
    "twitter",
    "solanaAddress",
    "evmAddress",
    "solanaSignerAddress",
    "linkedWallets"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "pending": {
      "type": "boolean",
      "const": true
    },
    "reason": {
      "type": "string",
      "enum": [
        "queued",
        "rate_limited",
        "unavailable",
        "no_preview"
      ]
    },
    "retryable": {
      "type": "boolean"
    },
    "retryAfterSeconds": {
      "description": "Present unless the reason is no_preview.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "pending",
    "reason",
    "retryable"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "handle": {
      "type": "string"
    },
    "displayName": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "avatarUrl": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "twitter": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Source-declared X profile URL from the same eligible public observation used for profile fields; null without evidence. This is not identity or wallet-ownership verification."
    },
    "followers": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ],
      "description": "Source-reported followers from eligible retained FOMO board evidence; null without evidence."
    },
    "wallet": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Present only when FOMO's own trade page attested this wallet and its persisted capture proof remains trusted. The page names the person's user id beside the wallet that traded the position. Proof survives raw-capture expiry; revoked or unknown proof returns null. Never one resolved from a handle. This Solana address is FOMO's account address for the person, not an on-chain trading wallet: none of these addresses signs a FOMO swap on chain, and those checked hold no account and no token account. The Solana wallet that signs and holds is solana_signer."
    },
    "evmWallet": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Present only when FOMO's own trade page attested this wallet and its persisted capture proof remains trusted. The page names the person's user id beside the wallet that traded the position. Proof survives raw-capture expiry; revoked or unknown proof returns null. Never one resolved from a handle."
    },
    "signerWallet": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Added: the Solana wallet that signs this trader's trades on chain: the native entry's solana_signer.wallet — inferred, never attested; null without a served link. The figures beside it are the leaderboard's, not computed from this wallet."
    },
    "updatedAt": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ],
      "description": "When the leaderboard figures were stored, epoch milliseconds."
    },
    "windows": {
      "type": "object",
      "properties": {
        "24h": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "netUsd": {
                  "type": "number",
                  "description": "The leaderboard's PnL for the window, USD — not a cash flow."
                },
                "returnPct": {
                  "type": "null",
                  "description": "Always null: the leaderboard publishes no percentage."
                },
                "volumeUsd": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Currently null in every window: the captured volume total has no proven window-specific period."
                },
                "trades": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Currently null in every window: the captured trade total has no proven window-specific period."
                },
                "rank": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "netUsd",
                "returnPct",
                "volumeUsd",
                "trades",
                "rank"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "7d": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "netUsd": {
                  "type": "number",
                  "description": "The leaderboard's PnL for the window, USD — not a cash flow."
                },
                "returnPct": {
                  "type": "null",
                  "description": "Always null: the leaderboard publishes no percentage."
                },
                "volumeUsd": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Currently null in every window: the captured volume total has no proven window-specific period."
                },
                "trades": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Currently null in every window: the captured trade total has no proven window-specific period."
                },
                "rank": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "netUsd",
                "returnPct",
                "volumeUsd",
                "trades",
                "rank"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "30d": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "netUsd": {
                  "type": "number",
                  "description": "The leaderboard's PnL for the window, USD — not a cash flow."
                },
                "returnPct": {
                  "type": "null",
                  "description": "Always null: the leaderboard publishes no percentage."
                },
                "volumeUsd": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Currently null in every window: the captured volume total has no proven window-specific period."
                },
                "trades": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Currently null in every window: the captured trade total has no proven window-specific period."
                },
                "rank": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "netUsd",
                "returnPct",
                "volumeUsd",
                "trades",
                "rank"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "all": {
          "type": "null"
        }
      },
      "required": [
        "24h",
        "7d",
        "30d",
        "all"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "handle",
    "displayName",
    "avatarUrl",
    "twitter",
    "followers",
    "wallet",
    "evmWallet",
    "signerWallet",
    "updatedAt",
    "windows"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "handle": {
      "type": "string"
    },
    "displayName": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "avatarUrl": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "twitter": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Source-declared X profile URL from the same eligible public observation used for profile fields; null without evidence. This is not identity or wallet-ownership verification."
    },
    "followers": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ],
      "description": "Source-reported followers from eligible retained FOMO board evidence; null without evidence."
    },
    "wallet": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Present only when FOMO's own trade page attested this wallet and its persisted capture proof remains trusted. The page names the person's user id beside the wallet that traded the position. Proof survives raw-capture expiry; revoked or unknown proof returns null. Never one resolved from a handle. This Solana address is FOMO's account address for the person, not an on-chain trading wallet: none of these addresses signs a FOMO swap on chain, and those checked hold no account and no token account. The Solana wallet that signs and holds is solana_signer."
    },
    "evmWallet": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Present only when FOMO's own trade page attested this wallet and its persisted capture proof remains trusted. The page names the person's user id beside the wallet that traded the position. Proof survives raw-capture expiry; revoked or unknown proof returns null. Never one resolved from a handle."
    },
    "signerWallet": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Added: the Solana wallet that signs this trader's trades on chain: the native entry's solana_signer.wallet — inferred, never attested; null without a served link. The figures beside it are the leaderboard's, not computed from this wallet."
    },
    "updatedAt": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ],
      "description": "When the leaderboard figures were stored, epoch milliseconds."
    },
    "windows": {
      "type": "object",
      "properties": {
        "24h": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "netUsd": {
                  "type": "number",
                  "description": "The leaderboard's PnL for the window, USD — not a cash flow."
                },
                "returnPct": {
                  "type": "null",
                  "description": "Always null: the leaderboard publishes no percentage."
                },
                "volumeUsd": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Currently null in every window: the captured volume total has no proven window-specific period."
                },
                "trades": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Currently null in every window: the captured trade total has no proven window-specific period."
                },
                "rank": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "netUsd",
                "returnPct",
                "volumeUsd",
                "trades",
                "rank"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "7d": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "netUsd": {
                  "type": "number",
                  "description": "The leaderboard's PnL for the window, USD — not a cash flow."
                },
                "returnPct": {
                  "type": "null",
                  "description": "Always null: the leaderboard publishes no percentage."
                },
                "volumeUsd": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Currently null in every window: the captured volume total has no proven window-specific period."
                },
                "trades": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Currently null in every window: the captured trade total has no proven window-specific period."
                },
                "rank": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "netUsd",
                "returnPct",
                "volumeUsd",
                "trades",
                "rank"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "30d": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "netUsd": {
                  "type": "number",
                  "description": "The leaderboard's PnL for the window, USD — not a cash flow."
                },
                "returnPct": {
                  "type": "null",
                  "description": "Always null: the leaderboard publishes no percentage."
                },
                "volumeUsd": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Currently null in every window: the captured volume total has no proven window-specific period."
                },
                "trades": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Currently null in every window: the captured trade total has no proven window-specific period."
                },
                "rank": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "netUsd",
                "returnPct",
                "volumeUsd",
                "trades",
                "rank"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "all": {
          "type": "null"
        }
      },
      "required": [
        "24h",
        "7d",
        "30d",
        "all"
      ],
      "additionalProperties": false
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "handle",
    "displayName",
    "avatarUrl",
    "twitter",
    "followers",
    "wallet",
    "evmWallet",
    "signerWallet",
    "updatedAt",
    "windows",
    "notes"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "missing": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "entries": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "handle": {
            "type": "string"
          },
          "displayName": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "avatarUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "twitter": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Source-declared X profile URL from the same eligible public observation used for profile fields; null without evidence. This is not identity or wallet-ownership verification."
          },
          "followers": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "Source-reported followers from eligible retained FOMO board evidence; null without evidence."
          },
          "wallet": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Present only when FOMO's own trade page attested this wallet and its persisted capture proof remains trusted. The page names the person's user id beside the wallet that traded the position. Proof survives raw-capture expiry; revoked or unknown proof returns null. Never one resolved from a handle. This Solana address is FOMO's account address for the person, not an on-chain trading wallet: none of these addresses signs a FOMO swap on chain, and those checked hold no account and no token account. The Solana wallet that signs and holds is solana_signer."
          },
          "evmWallet": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Present only when FOMO's own trade page attested this wallet and its persisted capture proof remains trusted. The page names the person's user id beside the wallet that traded the position. Proof survives raw-capture expiry; revoked or unknown proof returns null. Never one resolved from a handle."
          },
          "signerWallet": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Added: the Solana wallet that signs this trader's trades on chain: the native entry's solana_signer.wallet — inferred, never attested; null without a served link. The figures beside it are the leaderboard's, not computed from this wallet."
          },
          "updatedAt": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "When the leaderboard figures were stored, epoch milliseconds."
          },
          "windows": {
            "type": "object",
            "properties": {
              "24h": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "netUsd": {
                        "type": "number",
                        "description": "The leaderboard's PnL for the window, USD — not a cash flow."
                      },
                      "returnPct": {
                        "type": "null",
                        "description": "Always null: the leaderboard publishes no percentage."
                      },
                      "volumeUsd": {
                        "anyOf": [
                          {
                            "type": "number"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Currently null in every window: the captured volume total has no proven window-specific period."
                      },
                      "trades": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Currently null in every window: the captured trade total has no proven window-specific period."
                      },
                      "rank": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          {
                            "type": "null"
                          }
                        ]
                      }
                    },
                    "required": [
                      "netUsd",
                      "returnPct",
                      "volumeUsd",
                      "trades",
                      "rank"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "7d": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "netUsd": {
                        "type": "number",
                        "description": "The leaderboard's PnL for the window, USD — not a cash flow."
                      },
                      "returnPct": {
                        "type": "null",
                        "description": "Always null: the leaderboard publishes no percentage."
                      },
                      "volumeUsd": {
                        "anyOf": [
                          {
                            "type": "number"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Currently null in every window: the captured volume total has no proven window-specific period."
                      },
                      "trades": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Currently null in every window: the captured trade total has no proven window-specific period."
                      },
                      "rank": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          {
                            "type": "null"
                          }
                        ]
                      }
                    },
                    "required": [
                      "netUsd",
                      "returnPct",
                      "volumeUsd",
                      "trades",
                      "rank"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "30d": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "netUsd": {
                        "type": "number",
                        "description": "The leaderboard's PnL for the window, USD — not a cash flow."
                      },
                      "returnPct": {
                        "type": "null",
                        "description": "Always null: the leaderboard publishes no percentage."
                      },
                      "volumeUsd": {
                        "anyOf": [
                          {
                            "type": "number"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Currently null in every window: the captured volume total has no proven window-specific period."
                      },
                      "trades": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Currently null in every window: the captured trade total has no proven window-specific period."
                      },
                      "rank": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          {
                            "type": "null"
                          }
                        ]
                      }
                    },
                    "required": [
                      "netUsd",
                      "returnPct",
                      "volumeUsd",
                      "trades",
                      "rank"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "all": {
                "type": "null"
              }
            },
            "required": [
              "24h",
              "7d",
              "30d",
              "all"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "handle",
          "displayName",
          "avatarUrl",
          "twitter",
          "followers",
          "wallet",
          "evmWallet",
          "signerWallet",
          "updatedAt",
          "windows"
        ],
        "additionalProperties": false
      },
      "description": "In the order requested."
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "count",
    "missing",
    "entries",
    "notes"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "plan": {
      "type": "string"
    },
    "scopes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Always empty: a data key reads every path on its plan."
    },
    "entitlement": {
      "type": "object",
      "properties": {
        "monthlyUnits": {
          "type": "null"
        },
        "ratePerMinute": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "monthlyReveals": {
          "type": "null"
        },
        "unmetered": {
          "type": "boolean",
          "const": false
        }
      },
      "required": [
        "monthlyUnits",
        "ratePerMinute",
        "monthlyReveals",
        "unmetered"
      ],
      "additionalProperties": false
    },
    "usage": {
      "type": "object",
      "properties": {
        "period": {
          "type": "string",
          "description": "The UTC day, YYYY-MM-DD."
        },
        "unitsUsed": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991,
          "description": "Requests counted today, this one included."
        },
        "unitsRemaining": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "additionalUnits": {
          "type": "null"
        },
        "revealsUsed": {
          "type": "null"
        },
        "revealsRemaining": {
          "type": "null"
        }
      },
      "required": [
        "period",
        "unitsUsed",
        "unitsRemaining",
        "additionalUnits",
        "revealsUsed",
        "revealsRemaining"
      ],
      "additionalProperties": false
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "plan",
    "scopes",
    "entitlement",
    "usage",
    "notes"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string"
    },
    "username": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "bio": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The profile's own bio from the last stored profile read; null when none is stored."
    },
    "profileImage": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "xUsername": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The X handle pump.fun shows for the account — the platform's word, not a verification."
    },
    "isVerified": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "description": "pump.fun's own verified badge on the account, as pump.fun showed it; null when no stored observation carries one. The platform's word, not a verification of the X account or of wallet ownership."
    },
    "isPumpUser": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "description": "False for a wallet that traded without creating an account; null when no profile read is stored."
    },
    "followers": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "following": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ],
      "description": "From the last stored profile read; null when none is stored."
    },
    "groupBadges": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The names of the squads pump.fun names on the profile; empty when it names none or no profile read is stored."
    }
  },
  "required": [
    "wallet",
    "username",
    "bio",
    "profileImage",
    "xUsername",
    "isVerified",
    "isPumpUser",
    "followers",
    "following",
    "groupBadges"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "wallet": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "userName": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "xUsername": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The X handle pump.fun showed with the callout, else the caller's stored profile's."
    },
    "profileImage": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Stored caller image joined by the exact source wallet, else the image pump.fun showed with the callout; HTTPS only."
    },
    "isVerified": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "description": "pump.fun's own verified badge on the account, as pump.fun showed it; null when no stored observation carries one. The platform's word, not a verification of the X account or of wallet ownership."
    },
    "coinMint": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "chain": {
      "type": "string"
    },
    "coinSymbol": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "coinName": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "thesis": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The caller's own words; null when they wrote none."
    },
    "mediaUrl": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The media the caller attached, HTTPS only; null without one."
    },
    "calledOutAtMcap": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "multiple": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "maxMultiplier": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "createdAt": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Post time, epoch milliseconds."
    }
  },
  "required": [
    "id",
    "wallet",
    "userName",
    "xUsername",
    "profileImage",
    "isVerified",
    "coinMint",
    "chain",
    "coinSymbol",
    "coinName",
    "thesis",
    "mediaUrl",
    "calledOutAtMcap",
    "multiple",
    "maxMultiplier",
    "createdAt"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "hasMore": {
      "type": "boolean"
    },
    "nextBefore": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "wallet": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "userName": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "xUsername": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The X handle pump.fun showed with the callout, else the caller's stored profile's."
          },
          "profileImage": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Stored caller image joined by the exact source wallet, else the image pump.fun showed with the callout; HTTPS only."
          },
          "isVerified": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "pump.fun's own verified badge on the account, as pump.fun showed it; null when no stored observation carries one. The platform's word, not a verification of the X account or of wallet ownership."
          },
          "coinMint": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "chain": {
            "type": "string"
          },
          "coinSymbol": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "coinName": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "thesis": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The caller's own words; null when they wrote none."
          },
          "mediaUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The media the caller attached, HTTPS only; null without one."
          },
          "calledOutAtMcap": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "multiple": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "maxMultiplier": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "createdAt": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "description": "Post time, epoch milliseconds."
          }
        },
        "required": [
          "id",
          "wallet",
          "userName",
          "xUsername",
          "profileImage",
          "isVerified",
          "coinMint",
          "chain",
          "coinSymbol",
          "coinName",
          "thesis",
          "mediaUrl",
          "calledOutAtMcap",
          "multiple",
          "maxMultiplier",
          "createdAt"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "count",
    "hasMore",
    "nextBefore",
    "items"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "period": {
      "type": "string",
      "enum": [
        "daily",
        "weekly",
        "monthly"
      ]
    },
    "capturedAt": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ],
      "description": "Qualified observation time in epoch milliseconds, never the source window start or import time."
    },
    "count": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100
    },
    "entries": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "rank": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100
          },
          "wallet": {
            "type": "string",
            "pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$"
          },
          "username": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2048
              },
              {
                "type": "null"
              }
            ]
          },
          "profileImage": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2048
              },
              {
                "type": "null"
              }
            ]
          },
          "userId": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2048
              },
              {
                "type": "null"
              }
            ]
          },
          "xUsername": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^[A-Za-z0-9_]{1,15}$"
              },
              {
                "type": "null"
              }
            ],
            "description": "Source-declared X handle; not verified ownership or a FOMO identity."
          },
          "isVerified": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "Pump's profile flag, not verification of the X declaration."
          },
          "verifiedBadgeVisible": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          },
          "pnlSol": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "pnlUsd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "pnlPercent": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "realizedPnlSol": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "realizedPnlUsd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "unrealizedPnlSol": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "unrealizedPnlUsd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "buySpendSol": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Source buy-spend figure in SOL; not total buy+sell USD volume."
          },
          "positionsCount": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "lastRefreshedAtMs": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "topPositions": {
            "anyOf": [
              {
                "maxItems": 5,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "mint": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 128
                    },
                    "chainId": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991
                    },
                    "symbol": {
                      "anyOf": [
                        {
                          "type": "string",
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "name": {
                      "anyOf": [
                        {
                          "type": "string",
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "imageUri": {
                      "anyOf": [
                        {
                          "type": "string",
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "mint",
                    "chainId",
                    "symbol",
                    "name",
                    "imageUri"
                  ],
                  "additionalProperties": false
                }
              },
              {
                "type": "null"
              }
            ],
            "description": "Bounded source icons, not a full holdings inventory."
          }
        },
        "required": [
          "rank",
          "wallet",
          "username",
          "profileImage",
          "userId",
          "xUsername",
          "isVerified",
          "verifiedBadgeVisible",
          "pnlSol",
          "pnlUsd",
          "pnlPercent",
          "realizedPnlSol",
          "realizedPnlUsd",
          "unrealizedPnlSol",
          "unrealizedPnlUsd",
          "buySpendSol",
          "positionsCount",
          "lastRefreshedAtMs",
          "topPositions"
        ],
        "additionalProperties": false
      }
    },
    "note": {
      "type": "string"
    },
    "sourcePeriodType": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "sourcePeriodLabel": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "sourceWindowStartSec": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ],
      "description": "The source's declared window start, preserved without assuming it is a rolling window."
    },
    "sourceHttpDate": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Source HTTP Date metadata, separate from our observation clock."
    }
  },
  "required": [
    "period",
    "capturedAt",
    "count",
    "entries",
    "note",
    "sourcePeriodType",
    "sourcePeriodLabel",
    "sourceWindowStartSec",
    "sourceHttpDate"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "enum": [
            "VALIDATION_ERROR",
            "UNAUTHORIZED",
            "QUOTA_EXCEEDED",
            "FORBIDDEN",
            "NOT_OBSERVED",
            "NOT_FOUND",
            "BAD_REQUEST",
            "RATE_LIMITED",
            "OVERLOADED",
            "INTERNAL_ERROR"
          ]
        },
        "message": {
          "type": "string",
          "description": "Names the refused parameter, never its value."
        },
        "retryAfter": {
          "description": "Seconds; only on RATE_LIMITED.",
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "addUrl": {
          "description": "Where the answer lives instead; only on the socket path's NOT_FOUND.",
          "type": "string"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "error"
  ],
  "additionalProperties": false
}