API reference

Synthetic vs mainnet data

How a response tells you whether it came from real chain history.

The dataset label

Every ledger database is one of two kinds:

dataset.kindHolds
mainnetReal Solana chain history
syntheticGenerated demo data on a local network

A database is synthetic only if it carries a label, written once by the demo. The label table is append-only, so a synthetic database can never be relabelled real.

Where it appears

  • Responses. Portfolio, income, journal, yield and health include dataset: { kind, description }.
  • Headers. Every response carries x-corpact-dataset: mainnet | synthetic.
  • CSV exports. Every row starts with a dataset column, and synthetic files are named corpact-SYNTHETIC-….
  • Dashboard. A synthetic database shows a SYNTHETIC DEMO DATA banner on every page.
{
  "owner": "4zAX3B1QNWBvrMHQMxxjNUqQBecCFcaokULF1zkBAfyw",
  "dataset": { "kind": "synthetic", "description": "SYNTHETIC demo run …: generated keys, mints and issuer records on a local surfpool network (offline). Not mainnet history, not issuer data." }
}