Hosted Endpoints

Tycho Indexer's hosted endpoints

Tycho Indexer

Chain	URL
Ethereum (Mainnet)	tycho-beta.propellerheads.xyz
Base Mainnet	tycho-base-beta.propellerheads.xyz
Unichain Mainnet	tycho-unichain-beta.propellerheads.xyz

Tycho Fynd

Tycho Fynd endpoints are dedicated instances for Fynd users. They enforce stricter data filtering restrictions to support higher load.

Chain	URL
Ethereum (Mainnet)	tycho-fynd-ethereum.propellerheads.xyz
Base Mainnet	tycho-fynd-base.propellerheads.xyz
Unichain Mainnet	tycho-fynd-unichain.propellerheads.xyz

For API Documentation, Tycho Indexer includes Swagger docs, available at /docs/ path.

Example, for Mainnet: https://tycho-beta.propellerheads.xyz/docs/

Plans

Each API key is assigned a plan that determines rate limits and endpoint access.

Rate Limits

Plan	Requests/sec	Burst	Max WebSocket Connections	Allowed Endpoints
basic	50	300/s (6x)	2	Tycho Indexer, Tycho Fynd
fynd-basic	50	300/s (6x)	2	Tycho Fynd only

Need higher limits? Contact @tanay_j on Telegram.

Data Restrictions

Endpoints enforce data filtering restrictions on API queries. When a restriction is active, requests that do not include the required parameter values are rejected.

Tycho Indexer

Restriction	Value
Max version age	10 minutes
Protocol systems	All available
tvl_gt	No restriction
min_quality	No restriction
traded_n_days_ago	No restriction

Tycho Fynd

All Fynd endpoints share the same filtering restrictions:

Restriction	Value
Max version age	10 minutes
tvl_gt	10.0
min_quality	100
traded_n_days_ago	3

The available protocol systems vary by chain:

Chain	Protocol Systems
Ethereum (Mainnet)	uniswap_v2, uniswap_v3, uniswap_v4, sushiswap_v2, pancakeswap_v2, pancakeswap_v3, ekubo_v2, ekubo_v3, fluid_v1
Base Mainnet	uniswap_v2, uniswap_v3, uniswap_v4, pancakeswap_v3, aerodrome_slipstreams
Unichain Mainnet	uniswap_v2, uniswap_v3, uniswap_v4, velodrome_slipstreams

We're constantly adding new protocols. To see the current protocol systems for a specific endpoint, use the Retrieve protocol systems endpoint.

Metrics

Grafanatycho.live