/v0/state/acs endpoint. The ACS includes all contract types visible to the Global Synchronizer Foundation’s super validator node: Amulet UTXOs (CC balances), validator licenses, featured app rights, traffic contracts, transfer preapprovals, and governance contracts. As of 2026-04-01, the ACS contains 76,000+ active contracts. Snapshots are taken periodically (not per-block) and provide complete balance coverage across all parties — unlike the updates stream which only captures parties that recently transacted.
Table Details
| Property | Value |
|---|---|
| Table Name | canton.raw.active_contract_set_snapshots |
| Table Status | Beta 🌱 |
| Unique Key | record_time, contract_id |
| Clustering Key(s) | to_date("record_time") |
Table Columns
| Column Name | Data Type | Description |
|---|---|---|
| contract_id | VARCHAR(16777216) | Unique identifier for the Daml contract. Stable across its lifetime — the same contract_id appears in events when this contract is created or consumed. |
| event_id | VARCHAR(16777216) | The event_id of the created_event that originally created this contract. |
| event_type | VARCHAR(16777216) | Always created_event for ACS records — the ACS only contains active (not yet archived) contracts. |
| record_time | TIMESTAMP_NTZ(9) | The point-in-time at which this ACS snapshot was taken. All contracts in the same snapshot share the same record_time. |
| migration_id | NUMBER(38,0) | Synchronizer migration epoch. Canton upgrades increment this value (currently 0–4). The active migration_id must match the time range being queried. |
| template_id | VARCHAR(16777216) | The Daml template of this contract, formatted as package_hash:Module.Path:TemplateName. Common types include Splice.Amulet:Amulet (CC balances), Splice.ValidatorLicense:ValidatorLicense, and Splice.MemberTraffic:MemberTraffic. |
| package_name | VARCHAR(16777216) | Human-readable Daml package name (e.g., splice-amulet, splice-dso-governance, splice-wallet). |
| signatories | VARIANT | Array of parties that signed this contract. |
| observers | VARIANT | Array of parties that can observe this contract but are not signatories. |
| create_arguments | VARIANT | The constructor arguments of the contract, containing its full state. For Amulet contracts, includes owner, amount.initialAmount, amount.createdAt.number, and amount.ratePerRound.rate — the fields needed to compute the current CC balance via initialAmount - (currentRound - createdAtRound) × ratePerRound. |
| contract_created_at | TIMESTAMP_NTZ(9) | The record_time when this contract was originally created in the updates stream. Useful for computing contract age. |
| _created_at | TIMESTAMP_NTZ(9) | Timestamp of when the entry was created in the database. |
| _updated_at | TIMESTAMP_NTZ(9) | Timestamp of when the entry was last updated in the database. |