Skip to main content
GET
/
pairs
/
{address}
/
swaps
Get swap transactions by pair address
curl --request GET \
  --url https://deep-index.moralis.io/api/v2.2/pairs/{address}/swaps \
  --header 'X-API-Key: <api-key>'
{
  "result": [
    {
      "transactionHash": "0x2bfcba4715774420936669cd0ff2241d70e9abecab76c9db813602015b3134ad",
      "transactionIndex": 1,
      "transactionType": "buy",
      "blockTimestamp": "2022-02-22T00:00:00Z",
      "blockNumber": 21093423,
      "subCategory": "accumulation",
      "walletAddress": "0x2bfcba4715774420936669cd0ff2241d70e9abec",
      "baseTokenAmount": "1481.00",
      "quoteTokenAmount": "0.634",
      "baseTokenPriceUsd": 0.0734634,
      "quoteTokenPriceUsd": 23330,
      "baseQuotePrice": "0.00003376480687",
      "totalValueUsd": 1165
    }
  ],
  "page": "2",
  "pageSize": "100",
  "cursor": "<string>",
  "exchangeAddress": "0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f",
  "exchangeName": "Uniswap v2",
  "exchangeLogo": "https://entities-logos.s3.us-east-1.amazonaws.com/uniswap.png",
  "pairLabel": "BRETT/WETH",
  "pairAddress": "0x36a46dff597c5a444bbc521d26787f57867d2214",
  "baseToken": {
    "address": "0x003dde3494f30d861d063232c6a8c04394b686ff",
    "name": "BRETT",
    "symbol": "BRETT",
    "logo": "https://cdn.moralis.io/tokens/0x0000000000085d4780b73119b644ae5ecd22b376.png",
    "amount": "14811.98",
    "usdPrice": 0.078634,
    "usdAmount": 1155.33
  },
  "quoteToken": {
    "address": "0x003dde3494f30d861d063232c6a8c04394b686ff",
    "name": "BRETT",
    "symbol": "BRETT",
    "logo": "https://cdn.moralis.io/tokens/0x0000000000085d4780b73119b644ae5ecd22b376.png",
    "amount": "14811.98",
    "usdPrice": 0.078634,
    "usdAmount": 1155.33
  }
}
Endpoint cost: CUs. Learn more about compute units.

Authorizations

​
X-API-Key
string
header
default:test
required

Path Parameters

​
address
string
required

The pair address token-transactions are to be retrieved for.

Example:

"0xa43fe16908251ee70ef74718545e4fe6c5ccec9f"

Query Parameters

​
chain
enum<string>
default:eth

The chain to query

Available options:
eth,
0x1,
sepolia,
0xaa36a7,
polygon,
0x89,
bsc,
0x38,
bsc testnet,
0x61,
avalanche,
0xa86a,
fantom,
0xfa,
cronos,
0x19,
arbitrum,
0xa4b1,
chiliz,
0x15b38,
chiliz testnet,
0x15b32,
gnosis,
0x64,
gnosis testnet,
0x27d8,
base,
0x2105,
base sepolia,
0x14a34,
optimism,
0xa,
polygon amoy,
0x13882,
linea,
0xe708,
moonbeam,
0x504,
moonriver,
0x505,
moonbase,
0x507,
linea sepolia,
0xe705,
flow,
0x2eb,
flow-testnet,
0x221,
ronin,
0x7e4,
ronin-testnet,
0x7e5,
lisk,
0x46f,
lisk-sepolia,
0x106a,
pulse,
0x171,
sei-testnet,
0x530,
sei,
0x531,
monad,
0x8f
Example:

"eth"

​
cursor
string

The cursor returned in the previous response (used for getting the next page).

​
limit
integer

The desired page size of the result.

Required range: x >= 0
​
fromBlock
integer

The minimum block number from which to get the token transactions

  • Provide the param 'fromBlock' or 'fromDate'
  • If 'fromDate' and 'fromBlock' are provided, 'fromBlock' will be used.
Required range: x >= 0
​
toBlock
string

The block number to get the token transactions from

​
fromDate
string

The start date from which to get the token transactions (format in seconds or datestring accepted by momentjs)

  • Provide the param 'fromBlock' or 'fromDate'
  • If 'fromDate' and 'fromBlock' are provided, 'fromBlock' will be used.
​
toDate
string

The end date from which to get the token transactions (format in seconds or datestring accepted by momentjs)

  • Provide the param 'toBlock' or 'toDate'
  • If 'toDate' and 'toBlock' are provided, 'toBlock' will be used.
​
order
enum<string>
default:DESC

The order of the result, in ascending (ASC) or descending (DESC)

Available options:
ASC,
DESC
Example:

"DESC"

​
transactionTypes
string

Array of transaction types. Allowed values are 'buy', 'sell', 'addLiquidity', 'removeLiquidity'.

Response

200 - application/json

Returns swap transactions by pair address.

​
result
object[]
required
​
page
integer

The current page of the result

Example:

"2"

​
pageSize
integer

The number of results per page

Example:

"100"

​
cursor
string

The cursor to get to the next page

​
exchangeAddress
string
Example:

"0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f"

​
exchangeName
string
Example:

"Uniswap v2"

Example:

"https://entities-logos.s3.us-east-1.amazonaws.com/uniswap.png"

​
pairLabel
string
Example:

"BRETT/WETH"

​
pairAddress
string
Example:

"0x36a46dff597c5a444bbc521d26787f57867d2214"

​
baseToken
object
​
quoteToken
object