Query collection trade list by chain name and collection address

Description

• Method: HTTPS GET

• Encoding: UTF-8

• Path: https://api.blockin.ai/v2/nft/trade_list

• Description: Query collection trade list by chain name and collection address

Request Header

Parameter	Required	Type	Description
Content-Type	Y	String	application/json
AccessKey	Y	String	1bdb01c947c54919b64d1fc6794atest

Request Parameters

Parameter	Required	Type	Description
chain_name	Y	String	Chain's name,support single chain's name.eg:eth,Ethereum. Enumeration
address	N	String	Holder's address
direction	N	String	The direction of the trade. eg:buyer/seller/both
collection_address	Y	String	Collection's address
from_block	N	Long	The minimum block height from which to get the transfers If 'start_date' and 'from_block' are provided, 'from_block' will be used
to_block	N	Long	The maximum block height from which to get the transfers
start_date	N	String	The date from where to get the trades
end_date	N	String	Get trades up until this date If 'end_date' and 'to_block' are provided, 'to_block' will be used
marketplace	N	String	Marketplace from which to get the trades (OPENSEA/BLUR/X2Y2/LOOKSRARE/LARVALABS...)
page	Y	Integer	Page number
page_size	Y	Integer	Page size

Response

Public Response

Parameter	Required	Type	Description
success	Y	Boolean	Success Boolean
data	N	Object	Response object
error_code	N	String	Error code
error_msg	N	String	Error message

Response Content

Parameter	Required	Type	Description
list	Y	List	Paginated list
pagination	Y	Object	Page info

Pagination Content

Parameter	Required	Type	Description
current	Y	Integer	Current page number
page_size	Y	Integer	Current page size
total	Y	Integer	Total number
count_page	Y	Integer	Total page number

CollectionTrade Content

Parameter	Required	Type	Description
contract_address	Y	String	The address of the contract that traded the NFT
collection_address	Y	String	Collection's address
item_id	Y	String	Collection's item id
tx	Y	String	The transaction hash of the trade
buyer	Y	String	The buyer's wallet address
seller	Y	String	The seller's wallet address
amount	Y	String	Token's amount
payment_amount	Y	String	The amount that was sent in the transaction
payment_token	Y	String	The token that was sent in the transaction(ETH/BNB/MATIC...)
price	N	String	The Collection's item price
native_token_price	N	String	The Collection's item price of converting the payment token to the native token of the chain
block_height	Y	Long	The block height when the amount or owner changed
block_time	Y	Long	The timestamp of the block in which the trade occurred
block_hash	Y	String	The block hash
is_bind	Y	String	Determine whether it is a bound transaction(Y/N)
transaction_index	Y	Integer	The transaction index

Request Example

curl -H "Content-Type:application/json" -H "AccessKey:1bdb01c947c54919b64d1fc6794atest" -X GET "https://api.blockin.ai/v2/nft/trade_list?chain_name=eth&address=0x50d2d26cfb0680f21d9396ce43c64b82e1761bc4&direction=buyer&collection_address=0x0c9153d9abb5e0489c89b38837f248816f151f42&marketplace=OPENSEA&page=1&page_size=10"

Successful Response Example

{
    "success": true,
    "data": {
        "list": [
            {
                "contract_address": "0x00000000000000adc04c56bf30ac9d3c0aaf14dc",
                "collection_address": "0x0c9153d9abb5e0489c89b38837f248816f151f42",
                "buyer": "0x50d2d26cfb0680f21d9396ce43c64b82e1761bc4",
                "seller": "0x7fc855d576c05189dde9910602e39f1c35d9984d",
                "amount": "1",
                "payment_amount": "26900000000000000",
                "payment_token": "0x0000000000000000000000000000000000000000",
                "price": "0.0269",
                "block_hash": "0xb0df2c70db88aaea82e37506eebb007308ed4942d51da380cb0577817acf5d01",
                "is_bind": "N",
                "transaction_index": 73,
                "item_id": "1270",
                "tx": "0xec071135fc810dbc4023d3e63b925524df80fd924574ded7a0e2d7826eb04488",
                "native_token_price": "0.0269",
                "block_height": 17670573,
                "block_time": 1689080939
            }
        ],
        "pagination": {
            "current": 1,
            "page_size": 10,
            "total": 1,
            "count_page": 1
        }
    },
    "error_code": null,
    "error_msg": null
}

Failed Response Sample

{
    "success": false,
    "data": null,
    "error_code": "CHAIN_NOT_SUPPORT",
    "error_msg": "The current chain is not supported temporarily"
}