Query inscriptions on Bitcoin by user address

Description

  • Method: HTTPS GET

  • ncoding: UTF-8

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

  • Description: Query inscriptions on Bitcoin by user address

Request Header

Parameter
Required
Type
Description

Content-Type

Y

String

application/json

AccessKey

Y

String

1bdb01c947c54919b64d1fc6794atest

Request Parameters

Parameter
Required
Type
Description

address

Y

String

User's address

inscription_collection

N

Array

Collection's symbol

page

Y

Integer

Page number

page_size

Y

Integer

Page size(minimum:1 ,maximum:100)

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

Detail info list

pagination

Y

Integer

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

HolderItem Content

Parameter
Required
Type
Description

inscription_id

Y

String

NFT's id

inscription_number

Y

Long

NFT's number

holder_address

Y

String

The wallet address of the holder of the NFT

block_height

Y

Long

The block number when the amount or owner changed

amount

Y

Long

NFT's amount

inscription_collection

Y

String

Collection's symbol

collection_name

Y

String

Collection's name

item_metadata

Y

ItemMetadata

NFT's metadata

ItemMetadata Content

Parameter
Required
Type
Description

creation_transaction

N

String

Inscription hash

creation_block_height

N

Long

Inscription block height

creation_block_time

N

Long

Inscription block time

creation_fee

N

Long

Inscription fee

location

N

String

Location

location_block_height

N

Long

Location block height

location_block_time

N

Long

Location block time

location_block_hash

N

String

Location hash

output

N

String

Output

inscription_collection

N

String

Collection's symbol

inscription_name

N

String

NFT's name

collection_name

N

String

Collection's name

inscription_type

N

String

Inscription type

blockin_image

N

String

NFT's image url(Blockin.ai)

image

N

String

NFT's image url

sat_number

N

Long

Sat number

sat_name

N

String

Sat name

sat_rarity

N

String

Sat rarity

sat_block_height

N

Long

Sat block height

sat_block_time

N

Long

Sat block time

file_type

N

String

TXT,HTML,IMAGE,AUDIO,VIDEO,OTHER

file_size

N

Long

File size

attributes

N

list

NFT's arrtributes

Attribute Content

Parameter
Required
Type
Description

trait_type

Y

String

NFT's trait type

value

Y

String

Trait value

Request Sample

curl -H "Content-Type:application/json" -H "AccessKey:1bdb01c947c54919b64d1fc6794atest" -X GET "https://api.blockin.ai/v2/user/nft/btc/wallet_item_list?address=bc1pdkdhdftp9slhxx20pcpzp537pmaky2dl6ar6mxyx3t5qm6wpeu3qm2q4pz&page=1&page_size=100"

Successful Response Sample

Failed Response Sample

Last updated