Request Parameters

Name	Type	Description
`address`	`string`	The `address` is an optional (comma-separated) string used to specify one or more DEX pool addresses for which to return metadata. If the address parameter is not specified, the default behavior is to return `size` (default 10) results whose position is greater than or equal to `from` (default 0).
`from`	`integer`	An optional parameter used to specify from what position to return metadata for. The default value is 0.
`size`	`integer`	The number of records to return. The parameter is optional. If not specified, it defaults to 100. The maximum allowed is 10,000.
`chain`	`string`	Use `eth` for Ethereum, and `base` for Base. Default: `eth`

Response Fields

Name	Type	Description
`protocol_factory_address`	`string`	The factory address of the DEX pool.
`protocol_name`	`string`	The name of the DEX pool (e.g. `uniswap_v2`).
`timestamp_created`	`integer`	The UNIX timestamp in seconds that the pool was created.
`block_number_created`	`integer`	The block number at which the pool was created.
`pool_address`	`string`	The address of the pool.
`token_0_address`	`string`	The address of the first token that makes up the pool.
`token_1_address`	`string`	The address of the second token that makes up the pool.

FAQ

How often is the metadata updated?

Our metadata is updated in real-time. The moment a new pool is created we will have metadata for it (within a few seconds of a block being mined).

Live Example

Press Try It to make a request and see what the response looks like. Feel free to try different query parameters.