# Get NFT Trade History

## EndPoint

```
GET /api/v3/user/nft/trades
```

## Header

<table><thead><tr><th>Field</th><th>Description</th><th>Example</th><th data-hidden>Type</th><th data-hidden>Required</th></tr></thead><tbody><tr><td>X-API-KEY</td><td>ApiKey</td><td>"HlkcGxbqBeaF76j4rvPaOayfPwnkQ6B6DQ6THZWbvrGxzEdulXQvOKLrRWZLnN"</td><td></td><td>Y</td></tr></tbody></table>

## Request

<table><thead><tr><th>Field</th><th>Description</th><th>Example</th><th data-hidden>Type</th><th data-hidden>Required</th></tr></thead><tbody><tr><td>accountId</td><td>users accountId.</td><td>10001</td><td>integer</td><td>Y</td></tr><tr><td>nftData</td><td><mark style="color:orange;">(Optional)</mark> the nftData of the NFT token</td><td>"0xf7c932351186c3a9053f313eefa16209c018f7f1dba8aa8ca7100400f7c31085"</td><td>string</td><td>N</td></tr><tr><td>orderHash</td><td><mark style="color:orange;">(Optional)</mark> NFT order hash</td><td>"0xf7c932351186c3a9053f313eefa16209c018f7f1dba8aa8ca7100400f7c31085"</td><td>string</td><td>N</td></tr><tr><td>tradeHash</td><td><mark style="color:orange;">(Optional)</mark> NFT trade hash</td><td>"0xf7c932351186c3a9053f313eefa16209c018f7f1dba8aa8ca7100400f7c31085"</td><td></td><td></td></tr><tr><td>start</td><td><mark style="color:orange;">(Optional)</mark> Start time in milliseconds</td><td>1567053142000</td><td>integer</td><td>N</td></tr><tr><td>end</td><td><mark style="color:orange;">(Optional)</mark> End time in milliseconds</td><td>1567053142000</td><td>integer</td><td>N</td></tr><tr><td>startId</td><td><mark style="color:orange;">(Optional)</mark> The begin id of the query.</td><td>12</td><td>integer</td><td>N</td></tr><tr><td>limit</td><td><mark style="color:orange;">(Optional)</mark> Number of records to return, max is 50</td><td>20</td><td>integer</td><td>N</td></tr><tr><td>offset</td><td><mark style="color:orange;">(Optional)</mark> Number of records to skip</td><td>1</td><td></td><td></td></tr><tr><td>isASC</td><td><mark style="color:orange;">(Optional)</mark> Sort records in ascending order</td><td>true</td><td></td><td></td></tr></tbody></table>

## Response

<table><thead><tr><th>Field</th><th>Description</th><th>Example</th><th data-hidden>Type</th><th data-hidden>Required</th></tr></thead><tbody><tr><td>totalNum</td><td>total number</td><td>100</td><td>integer</td><td>Y</td></tr><tr><td>trades</td><td>List[<a href="#response">TradeInfo</a>], Trade info</td><td></td><td>List[List[string]]</td><td>Y</td></tr></tbody></table>

## Model

### TradeInfo

<table><thead><tr><th>Field</th><th>Description</th><th>Example</th><th data-hidden>Type</th><th data-hidden>Required</th></tr></thead><tbody><tr><td>id</td><td>the index</td><td>"1"</td><td>integer</td><td>Y</td></tr><tr><td>hash</td><td>nft trade hash</td><td>"0x2d4dcc071cb511cca912574aecb0076ba57e057b0716efb849b62da50926aa57"</td><td>List[List[string]]</td><td>Y</td></tr><tr><td>sellOrderHash</td><td>sell order hash</td><td>"0x199af4d4dcfbb7acae35d3b55a0ad99a0759f37dcef3388497e07008ec91a7d1"</td><td></td><td></td></tr><tr><td>buyOrderHash</td><td>buy order hash</td><td>"0x28b8415bd05dd7c68385e37870b6d9177cf7f8c2ba2e8ab151661114d546e799"</td><td></td><td></td></tr><tr><td>price</td><td>the price</td><td>"1.00000000"</td><td></td><td></td></tr><tr><td>nftData</td><td></td><td>"0x1a2001aac7a1fd00cef07889cdb67b1355f86e5bc9df71cfa44fa1c7b49f598f"</td><td></td><td></td></tr><tr><td>nftAmount</td><td>nft amount</td><td>"1"</td><td></td><td></td></tr><tr><td>nftTokenId</td><td>nft tokenId</td><td>"32768"</td><td></td><td></td></tr><tr><td>erc20TokenId</td><td>erc20 tokenId</td><td>"0"</td><td></td><td></td></tr><tr><td>sellFeeAmount</td><td>sell order fee amount</td><td>"10000000000000000"</td><td></td><td></td></tr><tr><td>buyFeeAmount</td><td>buy order fee amount</td><td>"1000000000000000"</td><td></td><td></td></tr><tr><td>blockId</td><td>the trade in layer2 block, useless now</td><td>"0"</td><td></td><td></td></tr><tr><td>indexInBlock</td><td>the index in block, useless now</td><td>"0"</td><td></td><td></td></tr><tr><td>sellAccountId</td><td>seller accountId</td><td>"12454"</td><td></td><td></td></tr><tr><td>buyAccountId</td><td>buyer accountId</td><td>"10488"</td><td></td><td></td></tr><tr><td>sellStorageId</td><td>seller storageId</td><td>"54"</td><td></td><td></td></tr><tr><td>buyStorageId</td><td>buyer storageId</td><td>"64"</td><td></td><td></td></tr><tr><td>createdAt</td><td>timestamp</td><td>"1653635906103"</td><td></td><td></td></tr><tr><td>submitter_accountId</td><td>the accountId submitted the nft trade</td><td>"10011"</td><td></td><td></td></tr><tr><td>sellAddress</td><td>seller address</td><td>"0x8656920c85342d646E5286Cb841F90209272ABeb"</td><td></td><td></td></tr><tr><td>buyAddress</td><td>buyer address</td><td>"0x5666920c85342d646E4392Lv457G79032322Z7dk"</td><td></td><td></td></tr></tbody></table>

###


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-protocol.loopring.io/counterfactual-nft/api-references/get-nft-trade-history.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.