Messari Subgraphs
Blockchain2023

MESSARISUBGRAPHS

Cryptopunks marketplace, Ellipsis AMM, Ribbon yield, Livepeer staking, GMX/Mummy/Level perps — each mapped to Messari’s institutional schema types.

7
Production subgraphs
4
Messari schema families
<2%
Institutional error budget
SCROLL
Client
Messari
Domain
Indexing
Platform
The Graph
Duration
Jan — Nov 2023
Core Stack
AssemblyScript · Mustache · TypeScript SDK
The Brief

THE
PROBLEM

Messari clients expect one financial grammar across NFT marketplaces, Curve forks, structured yield vaults, and perpetuals — seven protocols, four schema families.

Independent subgraphs per protocol with schema-nft-marketplace, schema-dex-amm, schema-yield, schema-derivatives-perpfutures, and schema-generic handlers; shared TypeScript SDK for GMX-style forks; on-chain reconciliation before promotion.

Core Engineering Challenge

Private Punk sales, Gnosis auction settlements, GMX fork reuse, and oracle wiring had to stay within a sub‑2% error budget while shipping Mustache-templated multi-chain manifests.

7
Protocols
4
Schemas
Extended stack
blockchain
The Graph
frontend
TypeScript
Subgraph
Subgraph
How we built it

THE ARCHITECTURE

01
Schema selection

Map each protocol to Messari schema-nft-marketplace, schema-dex-amm, schema-yield, schema-derivatives-perpfutures, or schema-generic.

The GraphMessari
02
ABI & handler authoring

Implement AssemblyScript mappings for factories, pools, auctions, bonding, and vault events with decimal normalization.

AssemblyScriptSolidity
03
Module layer

Metrics, revenue, and transaction helpers keep snapshots consistent across chains.

TypeScriptSubgraph
04
Multi-network configs

Mustache templates emit manifests per chain with addresses, start blocks, and RPC hints.

MustacheDevOps
05
Fork reuse

GMX/Mummy/Level share gmx-forks patterns; only config deltas ship for new deployments.

SDKDeFi
06
On-chain validation

Reconcile totals vs explorers before promotion; maintain sub-2% error budget.

QAEVM
System Data Flow
Ingestion
CrawlerContent Hash10K+ pages
Processing
ChunkerDeduplicatorEmbedding API
Storage
pgvectorPostgreSQLRedis Cache
Auth
Identity ProviderJWT BridgeSessions
Query
HNSW SearchRe-rankerLLM Stream
Delivery
Web AppMobile AppUsers
What we delivered

THE RESULTS

7

Cryptopunks, Ellipsis, Ribbon, Livepeer, GMX, Mummy, and Level — each with independent subgraphs yet unified Messari financial grammar so institutional dashboards could stack metrics without bespoke ETL per venue.

7
Protocols

Cryptopunks, Ellipsis, Ribbon, Livepeer, GMX, Mummy, and Level — each with independent subgraphs yet unified Messari financial grammar so institutional dashboards could stack metrics without bespoke ETL per venue.

4
Schemas

NFT marketplace, DEX AMM, yield, and derivatives/perp futures schemas plus generic handlers where needed; shared TypeScript SDK PRs reduced duplicated Pool/Position math across GMX-style forks.

Engineering decisions

TECH
DEEP DIVE

MUST
Mustache over hardcoded YAML

One template family drives dozens of network-specific manifests without merge conflicts on every address tweak.

Fork-reuse for GMX-style protocols cut weeks off sibling launches.

SDK
Shared TypeScript SDK

PoolManager/PositionManager abstractions centralize perp math so handlers stay thin.

Price oracle wiring (Chainlink, Aave, Uniswap) lived in one place, not seven copies.

Next Case Study
Blockchain
PendleBlueprints

Pendle V3 subgraph + SDK

The GraphPendle
Start a project

LET'S
BUILD
SOMETHING.

We take on a small number of projects at a time. If the problem is hard, we're interested.

Email
hello@techmusketeers.com
Response time
Within 24 hours
Availability
Open for new projects · 2025