Get Pairs by Address
Look up DEX pairs by their pair/LP contract addresses on a specific chain. Returns base token, quote token, price, volume, liquidity, and transaction data for each pair. Ideal for: enriching scraped pair data, resolving pair addresses to token info, getting market data for known pairs.
Catalog action Blockchain Data
Look up DEX pairs by their pair/LP contract addresses on a specific chain. Returns base token, quote token, price, volume, liquidity, and transaction data for each pair. Ideal for: enriching scraped pair data, resolving pair addresses to token info, getting market data for known pairs.
At a Glance
| Field | Value |
|---|---|
| Action ID | dexscreener-get-pairs-by-address |
| Category | Blockchain Data |
| Connector | Not required |
| Requires gas | No |
| Funds movement | None declared |
| Tags | dex, token, trading-pairs, price, liquidity, volume, read |
Payload Schema
| Field | Type | Required | Description |
|---|---|---|---|
chainId | string | Yes | Chain identifier (e.g. 'base', 'ethereum', 'solana'). |
pairAddresses | string | Yes | Comma-separated pair/LP contract addresses. |
Result Schema
| Field | Type | Required | Description |
|---|---|---|---|
pairs | array | Yes | List of pair data with base/quote tokens, price, volume, and liquidity |
Examples
json{ "type": "dexscreener-get-pairs-by-address", "payload": { "chainId": 8453, "pairAddresses": "example-pairAddresses" }, "children": []}
bashcurl -X POST "https://api.b3os.org/v1/actions/dexscreener-get-pairs-by-address/test" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "inputs": { "chainId": 8453, "pairAddresses": "example-pairAddresses" }}'
Payload fields can use workflow expressions such as {{$trigger.body.amount}}, {{$nodes.fetch.result.price}}, and {{$props.asset}} when the value should come from a trigger, prior node, or reusable workflow prop.