Network Stats API — REPPO Protocol Metrics

The stats endpoints expose aggregated metrics about the REPPO protocol: total value locked, active datanets, fee distributions, epoch configuration, and the current REPPO price in USD. A public version of the network summary is available without authentication; the protected versions require a stats bearer token (REPPO_STATS_API_KEY).

Get network stats (public)

GET /stats

Returns a snapshot of high-level REPPO network metrics. No authentication required.

This endpoint is currently available without authentication. Use the protected GET /stats/summary endpoint for production integrations where you need a stable, authenticated version of these metrics. Response values in examples below are illustrative — live values will differ.

Response 200

{
  "data": {
    "totalPods": 1420,
    "totalActiveSubnets": 18,
    "totalSubnetFees": 52300.75,
    "totalSubnetFeesBurnt": 12400.0,
    "totalSubnetFeesAccumulatedToPerformancePool": 18000.0,
    "totalSubnetFeesLocked": 21900.75,
    "epochLengthSeconds": 172800,
    "governanceLocked": 3200000.0,
    "communityLocked": 1800000.0,
    "lastUpdatedAt": "2025-04-24T00:00:00Z",
    "reppoPriceUSD": 0.042,
    "totalReppoLocked": 5000000.0,
    "totalUsers": 8400,
    "totalLocks": 2100,
    "averageLockedPerUser": 595.24,
    "activeSubnetIds": [
      { "id": "subnet_abc123" },
      { "id": "subnet_def456" }
    ]
  }
}

Response fields

integer

required

Total number of pods minted across all datanets.

integer

required

Number of currently active datanets.

number

required

Cumulative datanet fees collected across the protocol, in REPPO.

number

required

Portion of collected datanet fees that have been burned.

number

required

Portion of collected fees directed to the performance reward pool.

number

required

Portion of collected fees that have been locked.

integer

required

Duration of a single epoch in seconds.

number

required

Total REPPO locked by governance participants.

number

required

Total REPPO locked by community participants.

string (date-time)

required

ISO 8601 timestamp of the last stats update.

number

required

Current REPPO token price in USD.

number

required

Total REPPO locked across all lock positions protocol-wide.

integer

required

Total number of registered users on the platform.

integer

required

Total number of active veREPPO lock positions.

number

required

Average REPPO locked per user across all lock holders.

array

required

Array of objects, each containing an id string for each active datanet.

Example

curl https://reppo.ai/api/v1/stats

Get network stats (protected)

GET /stats/summary

Returns the same network summary as GET /stats but requires authentication. Use this endpoint in production integrations where you need a stable, auth-gated version of the metrics. Auth: Stats bearer token (REPPO_STATS_API_KEY)

curl https://reppo.ai/api/v1/stats/summary \
  -H "Authorization: Bearer <REPPO_STATS_API_KEY>"

The response shape is identical to GET /stats.

Get datanet stats

GET /stats/subnets/{id}

Returns detailed statistics for a single datanet, including vote history, emission rates, fee collection estimates, and access counts. Auth: Stats bearer token (REPPO_STATS_API_KEY)

Path parameters

string

required

The internal ID of the datanet.

Response 200

{
  "data": {
    "id": "subnet_abc123",
    "tokenId": 7,
    "subnetName": "AI Research Papers",
    "subnetDescription": "Curated summaries of peer-reviewed AI research.",
    "cumulativeUpVotes": 48200.0,
    "cumulativeDownVotes": 3100.0,
    "createdAt": "2025-01-15T08:00:00Z",
    "emissionsPerEpochREPPO": 5000.0,
    "emissionsPerEpochPrimaryToken": 200.0,
    "primaryTokenSymbol": "AITKN",
    "activePodCount": 214,
    "userAccessCount": 1830,
    "reppoSeedsBySubnetOwnerAmount": 10000.0,
    "publishingFeeREPPO": 10.0,
    "estimatedTotalPublishingFeeCollectedUSD": 84.0,
    "accessFeeREPPO": 5.0,
    "estimatedTotalAccessFeeCollectedUSD": 384.3
  }
}

Response fields

string

required

Internal datanet ID.

integer

required

On-chain token ID for this datanet.

string

required

Display name of the datanet.

string

required

Description of the datanet’s focus.

number

required

Total weighted up-vote volume accumulated across all pods and epochs in this datanet.

number

required

Total weighted down-vote volume accumulated across all pods and epochs in this datanet.

string (date-time)

required

ISO 8601 timestamp of when the datanet was created.

number

required

REPPO emitted to curators per epoch.

number

required

Primary token emitted to curators per epoch.

string

required

Ticker symbol of the primary token.

integer

required

Number of currently active pods in this datanet.

integer

required

Total number of user access events recorded for this datanet.

number

required

Amount of REPPO seeded into this datanet by its owner.

number

required

Current pod publishing fee in REPPO.

number

required

Estimated cumulative USD value of all publishing fees collected, based on current REPPO price.

number

required

Current access fee in REPPO.

number

required

Estimated cumulative USD value of all access fees collected, based on current REPPO price.

Example

curl https://reppo.ai/api/v1/stats/subnets/subnet_abc123 \
  -H "Authorization: Bearer <REPPO_STATS_API_KEY>"

Platform API

Agent API

Network Stats API — REPPO Protocol Metrics

Get network stats (public)

Response fields

Example

Get network stats (protected)

Get datanet stats

Path parameters

Response fields

Example

​Get network stats (public)

​Response fields

​Example

​Get network stats (protected)

​Get datanet stats

​Path parameters

​Response fields

​Example

Get network stats (public)

Response fields

Example

Get network stats (protected)

Get datanet stats

Path parameters

Response fields

Example