# Get pool trades

> For the complete documentation index, see [llms.txt](/docs/llms.txt).

GET https://api.g.alchemy.com/trading/v1/{apiKey}/pools/{network}/{poolAddress}/trades

**Private preview:** Paths, parameters, response fields, and tier names are provisional.

**Compute units:** 400 (proposed; pending validation).

Support for more networks is planned. Read individual trades. Range requests are limited.

Use pageKey until it is null.

Trade side and amount refer to the row’s tokenAddress.

Reference: https://www.alchemy.com/docs/data/trading-api/endpoints/pools/get-pool-trades

## Path Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| apiKey | string | Yes |  |
| network | enum | Yes | Supported networks for this operation during private preview. |
| poolAddress | string | Yes |  |

## Query Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| from | string | Yes | Start of the requested UTC time range. Boundary inclusion is pending. |
| to | string | Yes | End of the requested UTC time range. Boundary inclusion is pending. |
| pageKey | string | No | Omit for the first page. Reuse the returned key unchanged; stop when the response key is null. |
| pageSize | integer | No | Maximum rows per page; provisional limit. |

## Code Examples

### cURL

```bash
curl --request GET \
  --url 'https://api.g.alchemy.com/trading/v1/docs-demo/pools/eth-mainnet/0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640/trades?from=string&to=string'
```

### JavaScript

```javascript
const options = {method: 'GET'};

fetch('https://api.g.alchemy.com/trading/v1/docs-demo/pools/eth-mainnet/0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640/trades?from=string&to=string', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

### Python

```python
import requests

url = "https://api.g.alchemy.com/trading/v1/docs-demo/pools/eth-mainnet/0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640/trades?from=string&to=string"

response = requests.get(url)

print(response.text)
```

### Go

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.g.alchemy.com/trading/v1/docs-demo/pools/eth-mainnet/0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640/trades?from=string&to=string"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

### Java

```java
HttpResponse<String> response = Unirest.get("https://api.g.alchemy.com/trading/v1/docs-demo/pools/eth-mainnet/0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640/trades?from=string&to=string")
  .asString();
```

### C#

```csharp
using RestSharp;


var options = new RestClientOptions("https://api.g.alchemy.com/trading/v1/docs-demo/pools/eth-mainnet/0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640/trades?from=string&to=string");
var client = new RestClient(options);
var request = new RestRequest("");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);

```


## Operation Specification

```yaml
path: /{apiKey}/pools/{network}/{poolAddress}/trades
method: GET
operation:
  summary: Get pool trades
  operationId: get-pool-trades
  tags:
    - Pools
  x-shape-pending: true
  description: |-
    **Private preview:** Paths, parameters, response fields, and tier names are provisional.

    **Compute units:** 400 (proposed; pending validation).

    Support for more networks is planned. Read individual trades. Range requests are limited.

    Use pageKey until it is null.

    Trade side and amount refer to the row’s tokenAddress.
  parameters:
    - name: apiKey
      in: path
      required: true
      schema:
        type: string
        default: docs-demo
        description: For higher throughput, [create your own API key](https://dashboard.alchemy.com/signup)
    - name: network
      in: path
      required: true
      description: Supported networks for this operation during private preview.
      schema:
        x-shape-pending: true
        type: string
        enum:
          - eth-mainnet
          - base-mainnet
          - arb-mainnet
          - bnb-mainnet
          - solana-mainnet
    - name: poolAddress
      in: path
      required: true
      schema:
        type: string
        description: Pool address or pool identifier.
        x-shape-pending: true
      example: '0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640'
    - name: from
      in: query
      required: true
      schema:
        type: string
        format: date-time
        x-shape-pending: true
      description: Start of the requested UTC time range. Boundary inclusion is pending.
    - name: to
      in: query
      required: true
      schema:
        type: string
        format: date-time
        x-shape-pending: true
      description: End of the requested UTC time range. Boundary inclusion is pending.
    - name: pageKey
      in: query
      description: Omit for the first page. Reuse the returned key unchanged; stop when the response key is null.
      schema:
        type: string
        x-shape-pending: true
    - name: pageSize
      in: query
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 25
        x-shape-pending: true
      description: Maximum rows per page; provisional limit.
  responses:
    '200':
      description: Successful response.
      content:
        application/json:
          schema:
            type: object
            properties:
              data:
                type: array
                items:
                  type: object
                  properties:
                    network:
                      description: Alchemy network slug.
                      x-shape-pending: true
                      type: string
                      enum:
                        - eth-mainnet
                        - base-mainnet
                        - arb-mainnet
                        - bnb-mainnet
                        - solana-mainnet
                        - opt-mainnet
                        - matic-mainnet
                        - avax-mainnet
                        - linea-mainnet
                        - hyperliquid-mainnet
                        - robinhood-mainnet
                        - arc-mainnet
                        - tempo-mainnet
                    transactionHash:
                      type: string
                      description: Onchain transaction hash.
                      x-shape-pending: true
                    timestamp:
                      type:
                        - string
                        - 'null'
                      format: date-time
                      description: ISO 8601 UTC timestamp; null means unknown.
                      x-shape-pending: true
                    address:
                      type: string
                      description: Wallet address that made the trade.
                      x-shape-pending: true
                    poolAddress:
                      type: string
                      description: Pool address or pool identifier.
                      x-shape-pending: true
                    tokenAddress:
                      type: string
                      description: Token address that defines price and trade direction in this row.
                      x-shape-pending: true
                    side:
                      type: string
                      enum:
                        - buy
                        - sell
                      description: Buy or sell relative to this row’s tokenAddress.
                      x-shape-pending: true
                    amount:
                      type:
                        - string
                        - 'null'
                      pattern: ^-?[0-9]+(\.[0-9]+)?$
                      description: Traded token amount. Decimal string; null means unknown.
                      x-shape-pending: true
                    volumeUsd:
                      type:
                        - string
                        - 'null'
                      pattern: ^-?[0-9]+(\.[0-9]+)?$
                      description: Trade value in USD. Decimal string; null means unknown.
                      x-shape-pending: true
                    sent:
                      type: array
                      items:
                        type: object
                        properties:
                          network:
                            description: Alchemy network slug.
                            x-shape-pending: true
                            type: string
                            enum:
                              - eth-mainnet
                              - base-mainnet
                              - arb-mainnet
                              - bnb-mainnet
                              - solana-mainnet
                              - opt-mainnet
                              - matic-mainnet
                              - avax-mainnet
                              - linea-mainnet
                              - hyperliquid-mainnet
                              - robinhood-mainnet
                              - arc-mainnet
                              - tempo-mainnet
                          tokenAddress:
                            type: string
                            description: Token address.
                            x-shape-pending: true
                          amount:
                            type:
                              - string
                              - 'null'
                            pattern: ^-?[0-9]+(\.[0-9]+)?$
                            description: Token amount. Decimal string; null means unknown.
                            x-shape-pending: true
                        required:
                          - network
                          - tokenAddress
                          - amount
                      description: Tokens sent in the trade.
                      x-shape-pending: true
                    received:
                      type: array
                      items:
                        type: object
                        properties:
                          network:
                            description: Alchemy network slug.
                            x-shape-pending: true
                            type: string
                            enum:
                              - eth-mainnet
                              - base-mainnet
                              - arb-mainnet
                              - bnb-mainnet
                              - solana-mainnet
                              - opt-mainnet
                              - matic-mainnet
                              - avax-mainnet
                              - linea-mainnet
                              - hyperliquid-mainnet
                              - robinhood-mainnet
                              - arc-mainnet
                              - tempo-mainnet
                          tokenAddress:
                            type: string
                            description: Token address.
                            x-shape-pending: true
                          amount:
                            type:
                              - string
                              - 'null'
                            pattern: ^-?[0-9]+(\.[0-9]+)?$
                            description: Token amount. Decimal string; null means unknown.
                            x-shape-pending: true
                        required:
                          - network
                          - tokenAddress
                          - amount
                      description: Tokens received in the trade.
                      x-shape-pending: true
                  required:
                    - network
                    - transactionHash
                    - timestamp
                    - address
                    - side
                    - volumeUsd
                    - tokenAddress
                x-shape-pending: true
              pageKey:
                type:
                  - string
                  - 'null'
                description: Opaque continuation key. Pass it unchanged to the next request; null marks the last page.
                x-shape-pending: true
            required:
              - data
              - pageKey
          example:
            data:
              - network: eth-mainnet
                transactionHash: '0xe0ebd07409bae528d27b652d2ad9a3895f98717cf430cfdd6dc643db04d385f5'
                timestamp: '2026-10-30T05:08:35Z'
                address: '0xace0000083d3952db57d903f26f2009480d3ebc1'
                side: buy
                volumeUsd: '197.579678870079'
                sent:
                  - network: eth-mainnet
                    tokenAddress: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'
                    amount: '197.654553'
                received:
                  - network: eth-mainnet
                    tokenAddress: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2'
                    amount: '0.0880519091180887'
                tokenAddress: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2'
                amount: '0.0880519091180887'
              - network: eth-mainnet
                transactionHash: '0xd6d713fcdf3b3b94aaccee340e2263e21782fd2994023852f6397e3b6e69b4f4'
                timestamp: '2026-10-30T05:08:35Z'
                address: '0xe5533973a73b494fc241f1673e2c1426bb4d7f59'
                side: sell
                volumeUsd: '7998.29535564857'
                sent:
                  - network: eth-mainnet
                    tokenAddress: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2'
                    amount: '3.56446158725815'
                received:
                  - network: eth-mainnet
                    tokenAddress: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'
                    amount: '7992.369342'
                tokenAddress: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2'
                amount: '3.56446158725815'
            pageKey: null
    '400':
      description: Invalid request parameters.
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: object
                properties:
                  message:
                    type: string
                    description: Detailed error message.
                    x-shape-pending: true
                required:
                  - message
                x-shape-pending: true
            required:
              - error
          example:
            error:
              message: Invalid request parameters.
    '401':
      description: Invalid API key.
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: object
                properties:
                  message:
                    type: string
                    description: Detailed error message.
                    x-shape-pending: true
                required:
                  - message
                x-shape-pending: true
            required:
              - error
          example:
            error:
              message: Invalid API key.
    '429':
      description: Request limit reached. Retry with backoff.
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: object
                properties:
                  message:
                    type: string
                    description: Detailed error message.
                    x-shape-pending: true
                required:
                  - message
                x-shape-pending: true
            required:
              - error
          example:
            error:
              message: Request limit reached. Retry with backoff.
    '503':
      description: Data temporarily unavailable. Retry with backoff.
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: object
                properties:
                  message:
                    type: string
                    description: Detailed error message.
                    x-shape-pending: true
                required:
                  - message
                x-shape-pending: true
            required:
              - error
          example:
            error:
              message: Data temporarily unavailable. Retry with backoff.
```
