Query items transfer list by chain name and user address

Description

• Method: HTTPS GET

• Encoding: UTF-8

• Path: https://api.blockin.ai/v2/user/nft/wallet_transfer_list

• Description: Query items transfer list by chain name and user address

Requset 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	Y	String	Holder's address
direction	N	String	The direction of the transfer. eg:from/to/both
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 transfers
end_date	N	String	Get transfers up until this date If 'end_date' and 'to_block' are provided, 'to_block' will be used
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

AddressTransfer Content

Parameter	Required	Type	Description
collection_address	Y	String	Collection's address
item_id	Y	String	Collection's item id
tx	Y	String	The transaction hash of the transfer
block_height	Y	Long	The block height when the amount or holder changed
block_time	Y	Long	The timestamp of the block in which the transfer occurred
block_hash	Y	String	The hash of the block in which the transfer occurred
transfer_from	Y	String	The address from which the NFT was transferred
transfer_to	Y	String	The address to which the NFT was transferred
amount	Y	String	The amount of NFT items was transfered
operator	Y	String	The operator associated with the transfer (applicable for 1155 standard)
value	Y	String	The value of the transaction
transaction_type	Y	String	The type of the transaction,(Single, Batch)
transaction_index	Y	Integer	The index of the transaction
log_index	Y	Integer	The index of the log
contract_type	Y	String	The standard of the NFT (721, 1155)

Request Sample

curl -H "Content-Type:application/json" -H "AccessKey:1bdb01c947c54919b64d1fc6794atest" -X GET "https://api.blockin.ai/v2/user/nft/wallet_transfer_list?chain_name=eth&address=0x7c6d5cf17d05fdd70fb051366a474f7b422d86a6&page=1&page_size=10"

Successful Response Sample

{
    "success": true,
    "data": {
        "list": [
            {
                "collection_address": "0xe3677b719308cb2cb15be33bda68d4fef19c56f4",
                "tx": "0x5672141b607f39c76b49f37ead9e2dd27caacd73cecbcfea807ab32c037bd7f9",
                "block_hash": "0xfa38715c57a77e5fd3882754cae0ce21b36fe37bff97159bccbeab612f9353b6",
                "transfer_from": "0x0000000000000000000000000000000000000000",
                "transfer_to": "0x7c6d5cf17d05fdd70fb051366a474f7b422d86a6",
                "amount": "1",
                "operator": null,
                "value": "0",
                "transaction_type": "Single",
                "transaction_index": 70,
                "log_index": 351,
                "contract_type": "ERC721",
                "item_id": "3902",
                "block_height": 16653722,
                "block_time": 1676701403
            }
        ],
        "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"
}