Historical data for the Convex platform (https://convexfinance.com/) The subgraphs included in this repository index various on-chain events and entities that can be useful to produce analytics for the platform.
There are several subgraphs, each indexing a different aspect of the platform.
Currently available subgraphs:
- convex: Indexes events around the Booster contract where users deposit their Curve LP tokens. Allows, for instance, to query a pool's historical TVL and APR, platform revenue breakdown & users' withdrawals and deposits. (Live version)
- crv-emissions: Indexes emissions of CRV to pools with gauges as well as estimates of the fees generated by these pools. (Live version)
- locker: Indexes the vlCVX locker contract, allows to track the amount of CVX locked, the amount of rewards paid out over time. (Live version)
- staking: Indexes historical APR for Convex Staking contracts (currently cvxCRV & CVX only). (Live version)
- tricrypto: Indexes events of the tricrypto v2 pool on Curve. Soon to be expanded to all v2 pools. (Live version)
- votium: Indexes bribes deposited on the Votium platform. (Live version)
More to come!
You will need to install yarn, then run:
yarn install
To create the necessary files from the GraphQL schema and ABIs:
yarn run codegen
You may opt to only run the command for a specific subgraph by specifying its name, e.g. yarn run codegen:locker
To compile before deployment:
yarn run build
or specify a specific subgraph: yarn run build:locker
Authenticate to the graph with the graph auth
command, making sure that the auth token matches the platform where you'll deploy (studio vs. hosted for instance)
Use yarn run deploy
, yarn run deploy local
or yarn run deploy-hosted
or yarn run deploy-studio
to deploy.
The package.json
files will have to be updated to point to your own account on the Graph.
Notebooks with sample queries are available at: here