---
agentTools:
  projectIndex: https://0xscope.readme.io/llms.txt
---

# Returns trades of this NFT in a certain period of time

Returns trades of this NFT in a certain period of time

#### Sample Request

```curl
curl --request GET \
     --url 'https://api.0xscope.com/v2/nft/getTrades?contract_address=0xed5af388653567af2f388e6224dc7c4b3241c544&chain=ethereum&begin_time=2022-07-05&end_time=2022-08-05&limit=10&page=1' \
     --header 'API-KEY: your-api-key' \
     --header 'accept: */*'
```

#### Sample Response

```json
{
  "code": 0,
  "data": {
    "total": 473,
    "page": 1,
    "limit": 10,
    "rows": [
      {
        "timestamp": 1659734387,
        "tx_hash": "0xc244cd4fa21c2231c6a3be4a44a2d0fca4104d082e2787d1d4424f0ab9e36482",
        "platform": "LooksRare",
        "seller": "0x6b8df5e554f979dc93905ad42e0973349e4880c3",
        "buyer": "0xe4ae63c74cba2263842fb187bbac793fe60b2069",
        "price": "9.3500000000",
        "token_id": "1066"
      },
      {
        "timestamp": 1659720338,
        "tx_hash": "0x2766747af14eadcf8146ae93fa2342143472ccca0297bcadfa696095a3a995cc",
        "platform": "X2Y2",
        "seller": "0x82bbcac5a8b81368a4a96f0265cb40e46020a1e1",
        "buyer": "0x41bb70870e81291780493c13ae19cea81621bc69",
        "price": "8.6000000000",
        "token_id": "6680"
      },
      {
        "timestamp": 1659715919,
        "tx_hash": "0xe40603c4e54c7ccba216f2cec7111de52b903bc5947af5bdcfdcef23a1fc0f7f",
        "platform": "OpenSea",
        "seller": "0xe7a8a504a82f0a829656261a54d0443f85e19604",
        "buyer": "0xd5f8f3c066ce7c1d6f5e65ea80d93e91650d8248",
        "price": "12.5000000000",
        "token_id": "7294"
      },
      {
        "timestamp": 1659710382,
        "tx_hash": "0x43274fa3afb0597e9a922092567bc1189023a500cff558933f9c73939764315d",
        "platform": "sudoswap",
        "seller": "0x5847555c01e7b3ed23259d0f1a511e7a67177629",
        "buyer": "0x16f71d593bc6446a16ef84551cf8d76ff5973db1",
        "price": "7.9106796117",
        "token_id": "3613"
      },
      {
        "timestamp": 1659710220,
        "tx_hash": "0x847999844d486cd5a08e49c1d03c0478340f2d9c347f74091562e2cc762b3103",
        "platform": "OpenSea",
        "seller": "0x4e2e67836d10b02b1dce78591af6dfd1e2d7bcba",
        "buyer": "0x8d7e472e4b2ca8e80444632990f8d43ea5f45698",
        "price": "9.0000000000",
        "token_id": "6946"
      },
      {
        "timestamp": 1659697614,
        "tx_hash": "0x4d3b292ed1d65c437cb0aef26ad83eeb00af302ab3a7ec578996a798a160e843",
        "platform": "OpenSea",
        "seller": "0xa80cff1eff4ade72b21d5aabec6375bf0f69f073",
        "buyer": "0x33d5cc43debe407d20dd360f4853385135f97e9d",
        "price": "7.0000000000",
        "token_id": "6280"
      },
      {
        "timestamp": 1659669700,
        "tx_hash": "0x57f0487673ff486b18bdd27be8f385f7f65f9fb5c3831a209e0ea7cad9cd8ffb",
        "platform": "sudoswap",
        "seller": "0x16f71d593bc6446a16ef84551cf8d76ff5973db1",
        "buyer": "0xcd10dab662f24e87f643007632293c5085a42568",
        "price": "8.4000000000",
        "token_id": "2322"
      },
      {
        "timestamp": 1659638087,
        "tx_hash": "0x39077163a8a25e7524d89eb9f584a8a5071376fe29a462973c28c6e4d0fe79cb",
        "platform": "OpenSea",
        "seller": "0xc66cc247a5afbc647712e1d86fc9682ea80de372",
        "buyer": "0xf9f02def55e1cceedf017e0353c14ba6f7f4d3df",
        "price": "8.2500000000",
        "token_id": "4065"
      },
      {
        "timestamp": 1659635847,
        "tx_hash": "0xf754c92f33f9263ea3fdcbeeb79e541ae51ca37a6e17a8c6883b69893ddb2ab6",
        "platform": "OpenSea",
        "seller": "0x4f59ce7bb4777b536f09116b66c95a5d1ea8a8e6",
        "buyer": "0xe915bcc9bd87d92d442bde0d2390bff23485dde4",
        "price": "8.7990000000",
        "token_id": "6322"
      },
      {
        "timestamp": 1659631072,
        "tx_hash": "0x612cb329a69cd8ff3c988ce4d06750174652cb8c10674fe3edb4a6728c1a87f5",
        "platform": "OpenSea",
        "seller": "0x90ec199c9333ba04fafa6d907d9f9de2fd574b26",
        "buyer": "0xcfda01f12c7462e2c1cdf990aa8b7cc9ebbc5bf4",
        "price": "16.1250000000",
        "token_id": "1355"
      }
    ]
  },
  "uuid": 1656904536402821000
}
```

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "description": "doc",
    "version": "1.0",
    "title": "API Reference",
    "contact": {
      "name": "scope",
      "url": "www.0xscope.com",
      "email": "dev@0xscope.com"
    }
  },
  "paths": {
    "/nft/getTrades": {
      "get": {
        "tags": [
          "nft"
        ],
        "summary": "Returns trades of this NFT in a certain period of time",
        "description": "Returns trades of this NFT in a certain period of time",
        "operationId": "nft_getTrades",
        "parameters": [
          {
            "name": "contract_address",
            "in": "query",
            "description": "contract address of the nft",
            "required": true,
            "schema": {
              "type": "string",
              "default": "0xed5af388653567af2f388e6224dc7c4b3241c544"
            }
          },
          {
            "name": "chain",
            "in": "query",
            "description": "specific the network",
            "required": true,
            "schema": {
              "type": "string",
              "default": "ethereum"
            }
          },
          {
            "name": "begin_time",
            "in": "query",
            "description": "time of begin, example 2022-07-05",
            "required": true,
            "schema": {
              "type": "string",
              "default": "2022-07-05"
            }
          },
          {
            "name": "end_time",
            "in": "query",
            "description": "time of end, example 2022-08-05",
            "required": true,
            "schema": {
              "type": "string",
              "default": "2022-08-05"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "records count limit for one page(up to 100)",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 10
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "page count, start with 1",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/basicResult"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "data": {
                          "type": "array",
                          "description": "trades in this period of time",
                          "items": {
                            "type": "object",
                            "properties": {
                              "timestamp": {
                                "type": "integer",
                                "format": "int32",
                                "description": "Sale timestamp of the nft"
                              },
                              "tx_hash": {
                                "type": "string",
                                "description": "The hash"
                              },
                              "platform": {
                                "type": "string",
                                "description": "Exchange name"
                              },
                              "seller": {
                                "type": "string",
                                "description": "The seller"
                              },
                              "buyer": {
                                "type": "string",
                                "description": "The buyer"
                              },
                              "price": {
                                "type": "string",
                                "description": "The trade price"
                              },
                              "token_id": {
                                "type": "string",
                                "description": "The token id"
                              }
                            }
                          }
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "Authorization": [
              "global"
            ]
          }
        ],
        "deprecated": false
      }
    }
  },
  "servers": [
    {
      "url": "//api.0xscope.com/v2"
    }
  ],
  "components": {
    "securitySchemes": {
      "Authorization": {
        "type": "apiKey",
        "name": "API-KEY",
        "in": "header"
      }
    },
    "schemas": {
      "basicResult": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "format": "int32",
            "description": "result code"
          },
          "message": {
            "type": "string",
            "description": "if there is an error, this shows the detail"
          },
          "uuid": {
            "type": "integer",
            "format": "int64",
            "description": ""
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "_id": {
    "buffer": {
      "0": 100,
      "1": 93,
      "2": 214,
      "3": 66,
      "4": 56,
      "5": 97,
      "6": 95,
      "7": 3,
      "8": 73,
      "9": 22,
      "10": 71,
      "11": 219
    }
  }
}
```