Transparency

GoDark publishes all verifiable venue data through one public endpoint. No token, no bearer header, no account — a single GET returns every transparency surface for the current epoch, so anyone can consume it the same way.

Surface	Endpoint	Auth	What it proves
Venue transparency	`GET /transparency`	Public	Solvency, engine identity, and aggregate activity for the current epoch

Epochs are sequential integers. A new epoch is published every 60 minutes on the hour (UTC).

GET /transparency

Returns the latest epoch snapshot: proof-of-reserves root, engine attestation, and aggregate market/operations/node stats — in one response.

curl https://api.godarkdex.com/api/v1/transparency

Query Parameters

Parameter	Accepted values	Default	Notes
`epoch`	integer	current	Return a historical snapshot. Epochs older than 365 days may be pruned from hot storage; the gateway returns `404 epoch_not_available`.
`window`	`1h`, `24h`, `7d`, `30d`	`24h`	Window applied to aggregate stats. Reserves and attestation are always the epoch snapshot.

Response

{
  "code": 0,
  "data": {
    "epoch": 842,
    "published_at": "2026-04-20T10:00:00Z",
    "previous_epoch_root": "0x2e1c...a88f",
    "next_epoch_at": "2026-04-20T11:00:00Z",

    "reserves": {
      "merkle_root": "0x7a9f...c12b",
      "hash_algo": "sha256",
      "total_liabilities_usd": "124300000.00",
      "accounts": [
        {
          "asset": "USDC",
          "chain": "solana",
          "address": "CusT0dyVaU1t...",
          "balance": "128450000.000000",
          "proof_tx": "5XyZ..."
        }
      ]
    },

    "attestation": {
      "engine": {
        "code_hash": "sha256:4f19...de02",
        "tee": {
          "type": "SGX",
          "quote": "base64:AAAAB3Nz...==",
          "verified_at": "2026-04-20T09:59:58Z"
        }
      },
      "committee": {
        "threshold": "3-of-5",
        "rotation_epoch": 840,
        "members": [
          { "id": "mpc-a", "operator": "Region US-East",  "pubkey": "0xab12..." },
          { "id": "mpc-b", "operator": "Region EU-West",  "pubkey": "0xcd34..." },
          { "id": "mpc-c", "operator": "Region APAC",     "pubkey": "0xef56..." },
          { "id": "mpc-d", "operator": "Region US-West",  "pubkey": "0x7890..." },
          { "id": "mpc-e", "operator": "Region EU-North", "pubkey": "0x12ab..." }
        ]
      },
      "signatures": [
        { "signer": "mpc-a", "sig": "0x..." },
        { "signer": "mpc-b", "sig": "0x..." },
        { "signer": "mpc-c", "sig": "0x..." }
      ]
    },

    "stats": {
      "window": "24h",
      "as_of": "2026-04-20T10:00:00Z",
      "market": {
        "matched_volume_usd": "84250000.00",
        "liquidity_submitted_usd": "1420800000.00",
        "buy_sell_ratio": 1.03,
        "avg_time_to_fill_ms": 412,
        "unique_wallets": 1847,
        "avg_order_size_usd": "5823.10",
        "matched_trade_count": 48210,
        "order_count": 244110
      },
      "operations": {
        "fees_collected_usd": "42180.55",
        "avg_settlement_finality_ms": 1820,
        "ephemeral_wallet_assets_usd": "3121000.00",
        "failed_settlements": 0,
        "system_downtime_seconds": 0,
        "avg_api_response_ms": 38
      },
      "nodes": {
        "live_sequencer_nodes": 3,
        "live_verifier_nodes": 5,
        "total_nodes": 8,
        "node_network_24h_uptime_pct": 99.998
      }
    }
  },
  "timestamp": "2026-04-20T10:30:00.123Z"
}

Reserves Fields

Field	Type	Description
`merkle_root`	string	Root of the published reserves tree for this epoch.
`hash_algo`	string	Hash used to build the tree.
`total_liabilities_usd`	string	Sum of liabilities the reserves back.
`accounts[].asset`	string	Asset symbol held in the reserve.
`accounts[].chain`	string	Chain the reserve lives on.
`accounts[].address`	string	On-chain address to audit directly.
`accounts[].balance`	string	Balance recorded at snapshot time.
`accounts[].proof_tx`	string	Transaction hash that anchors the snapshot on-chain.

Attestation Fields

Field	Type	Description
`engine.code_hash`	string	Hash of the engine binary running this epoch.
`engine.tee.type`	string	TEE technology backing the engine.
`engine.tee.quote`	string	Base64 TEE quote that can be verified against the vendor's attestation service.
`committee.threshold`	string	Signing threshold of the matching committee (e.g. `3-of-5`).
`committee.members[]`	array	Committee members and their public keys.
`committee.rotation_epoch`	integer	Last epoch at which the committee rotated.
`signatures[]`	array	Threshold signatures over the epoch snapshot.

Stats Fields

Market

Field	Type	Description
`matched_volume_usd`	string	Notional value of matched trades in the window.
`liquidity_submitted_usd`	string	Total notional of orders submitted in the window (includes cancels and unfilled rest).
`buy_sell_ratio`	number	Buy-side notional divided by sell-side notional. `1.0` = balanced flow.
`avg_time_to_fill_ms`	integer	Average latency from order acceptance to first fill, across matched orders.
`unique_wallets`	integer	Distinct wallets that submitted at least one order in the window.
`avg_order_size_usd`	string	Average notional per submitted order (not per fill).
`matched_trade_count`	integer	Number of discrete fills in the window.
`order_count`	integer	Number of orders submitted in the window.

Operations

Field	Type	Description
`fees_collected_usd`	string	Total venue fees collected in the window.
`avg_settlement_finality_ms`	integer	Average time from match to Solana-finalized settlement.
`ephemeral_wallet_assets_usd`	string	Point-in-time balance across transient ephemeral wallets used for settlement flow. Gauge, not window-scoped.
`failed_settlements`	integer	Settlement batches that failed on-chain and required replay in the window.
`system_downtime_seconds`	integer	Total seconds the venue was unavailable to accept trading during the window.
`avg_api_response_ms`	integer	Average REST response latency across trading endpoints in the window.

Nodes

Field	Type	Description
`live_sequencer_nodes`	integer	Attested sequencer nodes currently participating. Gauge.
`live_verifier_nodes`	integer	Verifier nodes currently online. Gauge.
`total_nodes`	integer	Total nodes provisioned across the committee. Gauge.
`node_network_24h_uptime_pct`	number	Aggregate uptime across the node network over the last 24 hours.

No per-trade or per-user data is returned — only venue-level aggregates and on-chain anchors. This endpoint is safe to embed in public dashboards and to scrape unauthenticated.

WebSocket Notifications

Subscribe to the public transparency channel on wss://api.godarkdex.com/ws/v1 to be notified whenever a new epoch is published — no polling required:

{ "id": "c-1", "op": "subscribe", "args": { "channel": "transparency" } }

Events carry only the epoch number and root; fetch the full snapshot via GET /transparency when you need it.