> ## Documentation Index
> Fetch the complete documentation index at: https://artemis.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Protocol Data

> Snowflake schema documentation for 130+ blockchains and protocols. Covers metric naming conventions (prefix_root_suffix) for usage, cash flow, and supply data.

These schemas include data for over 130 blockchains, and their applications. Example schemas include bitcoin, ethereum, solana, base, uniswap, jupiter, hyperliquid, and many more.

## **Naming Conventions**

General Metric Name Structure: `{prefix}_{root}_{suffix}`

`prefix` - Describes the sector/protocol/category type this metric applies to

`root` **-** Core concept or value being measured.

`suffix` - Describes the unit or transformation

* no suffix means usd, not in currency units, or not a change metric

Example metric names:

* `fees`
* `chain_dau`
* `perp_volume`
* `spot_volume`
* `chain_spot_volume`

## Usage Metrics

### **Usage Metric Prefixes:**

[https://www.artemis.ai/sectors](https://www.artemis.ai/sectors)

* `chain`
* `perp`
* `bridge`
* `spot`
* `lending`
* `lst`
* `lrt`
* `da`
* `depin`
* `oracle`
* `rwa`
* `nft`

### Usage Metric Roots

* `dau` , `wau` , `mau`
* `txns`
* `volume`
* note: `tvl` does not take a sector prefix, unless a protocol has `tvl` for multiple sectors
  * eg. Jupiter has `perp_tvl` and `lst_tvl` but also an aggregate `tvl` metric

### Usage Metric Suffixes

* `net_change`
* `pct`

## Cash Flow Metrics

### **Cash Flow Metric Prefixes:** the “bucket" to whom the fee accrues

* `service` - revenue accrued to service providers of the protocol (LPs, compute providers, etc.)
* `equity` - revenue accrued to the equity entity
* `foundation` - revenue accrued to the protocol foundation
* `token` - revenue accrued to passive token holders
* `fee_sharing_token` - revenue accrued to active holders (eg. veAERO, vePENDLE)
* `treasury` - revenue accrued to the governance-controlled protocol treasury
* `burned` - portion of the fee that is burned (eg. ETH base fees)
* `buyback` - portion of fee that is allocated to buybacks

More buckets can be added if needed.

Prefixes may be stringed together for specificity eg. `aggregator_treasury_revenue`

### **Cash Flow Metric Roots**

* `fees` - what is paid by end users
* `fees` - top line revenue (equivalent to the sum of all individual`fees `, or `yield_generated` by the protocol)
* `cash_flow` - the value retained by an entity (eg. the ecosystem, validators, treasury, foundation)

### Cash Flow Suffixes

* `no suffix` - the associated value is in `USD`
* `native` - the associated value is in native units (typically in a `_by_token` table)
* `raw` - the associated value is in decimal *unadjusted* native units
* `net_change` - the value is the D/D abs change
* `pct_change` if percent change

## Supply Metrics

### Supply Metric Roots

Supply side metrics are typically suffixed with `_native` and are denominated in the protocol’s own token.

* `gross_emissions` - typically characterized as anything not in premine\_unlocks, including things like token incentives or programmatic emissions. Typically sourced from onchain data, or inferred from the whitepaper and docs.
* `premine_unlocks` - reserved for predetermined vesting of tokens (eg. insider/investor/team/etc token vesting). Typically sourced from the whitepaper and docs, or onchain data.
* `burns` - tokens permanently removed from circulating supply
* `net_supply_change` - the sum of gross emissions, premine unlocks, and burns, on a day to day basis.
* `circulating_supply` - a cumulative sum over net supply change

### Supply Metric Suffixes

* `native`

## **Additional Notes**

Suffixes can be stringed together eg. `tvl_native_net_change`