0x Documentation
Searchโ€ฆ
๐Ÿ“Š
How to Get 0x and Matcha Data
With Existing Tools and Resources
* updated as of Feb 3, 2022
This guide introduces the dashboards and tools available to explore 0x data, for different needs. In this piece, we are mainly focusing on ready-made analytics solutions that donโ€™t require advanced data scraping. The following solutions are ideal for teams working on analytics product or data information sites, looking to integrate 0x data with minimum effort; or for DeFi researchers/analysts looking for ready made, reliable sources about the 0x ecosystem. At the end of the document we provide links to resources for advanced use cases.

๐Ÿ—บ๏ธ Scope and Concepts โœ๏ธ

The following resources cover active versions of 0x exchange contracts (v2, v3, v4) and API endpoints (v1 /swap). Based on the most common use cases, we will introduce how to get data on different layers of the 0x ecosystem, which are defined as follows:

1. The DEX Layer - 0x Native

0x Native volume covers orders conforming to one of the 0x Native Order formats (currently two: Limit Order and Rfq Order) and are settled by 0x smart contracts. Orders generated from 0x open order book and RFQ system are settled on them. Besides that, as itโ€™s an open-source onchain infrastructure that any aggregator can use, 1inch exchange and Tokenlon have actively been using the 0x exchange contracts to settle trades. Thus this portion of volume has an overlap with other aggregatorsโ€™ volume, but no overlap with other AMM DEXes.

2. The Aggregator Layer - 0x API (/swap endpoint)

0x API is the endpoint that allows any integrator or individual to fetch available quotes from "makers" to match their own "taker" order.
It is an off-chain order matching system that compares prices across:
  • On-chain bridge liquidity (30+ AMM pools across chain like Uniswap, PancakeSwap, etc.)
  • Off-chain native liquidity from RFQ system with Professional Market Makersโ€™ quotes
  • Off-chain native liquidity from 0xโ€™s Open Order Book network (known as mesh, accessed via 0x API /sra endpoint)
It returns the best price source (or sources) to users and prepares the routing information to be settled on chain โ€” by 0x exchange contracts (native liquidity) or other DEXes' contracts (bridge liquidity).
This portion has an overlap with other DEXes' volume as the bridge liquidity will be settled on their origin DEXes, but thereโ€™s no overlap with other aggregators.

3. The Application Layer - Matcha and other 0x API Integrators

โ€‹Matcha is a user-facing product sitting on top of 0x API /swap and /sra endpoints. It fetches "maker" order via /swap endpoints for consumersโ€™ market orders; and submit "maker" order via /sra endpoints for consumersโ€™ limit orders which can later be sourced and potentially filled via /swap endpoint. Other integrators work in a similar way, but may include additional sources.

4. The Global Total - 0x Protocol

The term 0x Protocol is used to describe the total combined volume covering both 0x DEX layer (0x Native) and aggregator layer (0x API). As we mentioned above, 0x Native liquidity can potentially be "fetched" by 0x API as well, thus there is an overlap between these 2 attributions. We make sure to de-duplicate that part to avoid double counting.

Summary

Below is a summary table for different attributions:
Attribution
Availability on chains
Layer
Tag
Overlap with DEXes?
Notes
0x Native
Ethereum
Settlement Layer
DEX
No
native volume settled on 0x exchange contracts with fired events including Fill(), rfqOrderFilled() and limitOrderFilled()
0x API
Ethereum, BSC, Polygon, Avalanche, Fantom, Celo, Optimism
Aggregator Layer
Aggregator
Yes
native + bridge volume going thru 0x API /swap endpoint
0x API Integrator (e.g. Matcha)
Ethereum, BSC, Polygon, Avalanche, Fantom, Celo, Optimism
Application Layer
Aggregator (Integrator)
Yes
volume Integrator affiliated on top of 0x API /swap and /sra endpoints
0x Protocol
Ethereum, BSC, Polygon, Avalanche, Fantom, Celo, Optimism
Global
DEX + Aggregator
Yes
combined total 0x volume with de-duplication of overlap
Note: 0x Native (native exchange contracts) are deployed on multiple chains outside Ethereum, but not being actively used by any entity at the moment.

๐Ÿงฎ Available Data Tools ๐Ÿ“Ž

1.1 0xTracker

For those looking for the easiest way to explore data.
โ€‹0xTracker offers an easy to navigate interface to explore all 0x Protocol data, and tags each trade with the known entities involved. It allows the user to explore 0x data seamlessly through different cuts (API integrator, order book relayer, Market Maker, Trader).
Quick links to detailed views:

1.2 0xTracker API

For those looking for a REST API endpoint.
0xTracker also provides an API to access all the data available through the website, the docs are available at 0xTracker - API Docs. This is ideal for all the teams working on analytics products willing to easily integrate 0x data from a reliable source.
Quick links:
0xTracker is currently covering 0x on Ethereum Mainnet only. We at 0x Labs have plans to expand it so as to cover 0x in all other blockchains where 0x is present. We consider 0xTracker the first step towards a fully-fledged 0x Analytics hub.
While we work on that, we have produced a set of Public Dashboards that cover 0x API on all available blockchains (see next section).

1.3 0x Public Dashboards

For those looking for aggregated data from all chains.
0x Labs uses Metabase as the dashboarding tool and the team constantly opens up public links for ad-hoc data requests from our community. Keep an eye out on our Twitter updates for new dashboards!

1.4 The Graph

For those looking for a GraphQL endpoint.
0x Labs had released a subgraph for the 0x API /swap endpoint, which allows exploring 0x API data on Ethereum*:
Note: These subgraphs are no longer actively maintained, so they are not in sync with the latest version of the Exchange Proxy. The 0x Labs team is actively working on other tools that can help support these needs.
Other chains' subgraphs are currently not planned as it requires reliable & in-sync subgraphs of certain DEXes from where liquidity is sourced.

1.5 Dune Analytics

For those looking for retrospective data, charts and stats.
If you are just reporting for historic stats, please check out these dashboards:
Also comparison with other DEXes & Aggregators on:
If you are looking for stats on specific dates or attribution, you can click into the queries in the above dashboards, to simply fork the queries and change filter for dates or affiliate/relayer in SQL.

Disclaimer

We constantly work with the teams and maintain our external reporting on platforms mentioned above. Please refer to the list for reliable 0x data decoding. We are actively exploring partnerships with more data services and tools to expand external reporting offerings.

๐Ÿ”Ž Decode it from Scratch (Advanced) โ›“๏ธ

Do you believe that the truth can only be found in the blockchain?
  • If you don't have a data pipeline yet - our event scraper is open source and only requires an RPC endpoint and a Postgres DB (Contributions are also welcome).
  • If you already have a blockchain data ETL already, with the full copy of data processed into relational databases - our folder under DuneAnalytics' collaborative repo will be the best reference.
Feel free to reach out to [email protected] (@sui414) and [email protected] (@ktl_xv) for any questions!
The data must flow. ๐Ÿง™โ€โ™€๏ธ๐Ÿ”ฎ