📊
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.
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: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.
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
/sraendpoint)
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.
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.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.
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.
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:
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).
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!
- Multi-chain 0x API
- 0x API Integrator Deep dive (requires affiliate address input)
- Ethereum: https://0xtracker.com/apps
- For Individual Trader (requires a trader address input)
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.
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.
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.
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. 🧙♀️🔮
Last modified 7mo ago