Query User history - Advanced edition

Description

  • Method: HTTPS POST

  • Encoding: UTF-8

  • Path: https://api.blockin.ai/v2/user/history_list_pro

  • Description: Query user's history (Add address lable and transaction hash)

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

chain_name

N

String

Single chain'name. eg: eth,Ethereum. Enumeration

protocol_name

N

String

Protocol's name

token_address

N

String

Token's address

value_type

N

Integer

Value type tier

  1. value<=1,000u

  2. 1,000u<value<=10,000u

  3. 10,000u<value<=100,000u

  4. 100,000u<value<=1,000,000u

  5. value>1,000,000u

tx

N

String

Page param: Trading hash (Note: the first page:null,every subsequent page :the trading hash of the last item of the previous page)

start_time

N

Long

Page param: Trading time (Note: the first page :0 ; every subsequent page: the trading time of the last item of the previous page)

page_count

N

Integer

Number of entries returned, the maximum count is 100

Response

Public Response

Parameter
Required
Type
Description

success

Y

Boolean

Success Boolean

data

N

List

Response data

error_code

N

String

Error code

error_msg

N

String

Error message

Response Data Content

Parameter
Required
Type
Description

transaction_details

Y

List<Transaction_Details>

The list of Transaction details

chain_list

N

List<Chain>

The list of chain

token_list

N

List<Token>

The list of token

nft_item_list

N

List<Item>

The list of Nft item

collection_list

N

List<Collection>

The list of collection

protocol_list

N

List<Protocol>

The list of protocol

cex_list

N

List<Cex>

The list of cex

abi_list

N

List<ABI>

The list of ABI

Transaction_details

Parameter
Required
Type
Description

chain_name

Y

String

Chain

tx

Y

String

Trading hash

transaction_index

N

Int

Transaction index

receipt_status

N

Int

Trading status (1: Success, 0: Failure)

block_restructure

N

Int

Block Reorganizatior (1: True , 0: False)

block_height

Y

Long

Block number

block_time

Y

Long

Block time

nonce

N

Int

nonce

transaction_type

N

Int

Transaction type

from_address

N

String

From address

to_address

N

String

To address

value

N

BigDecimal

value (wei)

amount

N

BigDecimal

Quantity

usd_value

N

BigDecimal

USD Value

price

N

BigDecimal

Token price

token_address

N

String

Token address

transaction_fee

N

BigDecimal

Gas fee

method_id

N

String

method ID

function_name

N

String

Function

explain_action

N

String

Explain tags,eg: swap,burn,mint

protocol_name

N

String

Protocol name

contract_address

N

String

Contract address

cex_id

N

String

Dex id

gas_used

N

BigDecimal

Gas used

gas_price

N

BigDecimal

Gas price

is_scam

N

Boolean

If it's scam

transfer_logs

N

List<transfer_logs>

Transfer logs

internal_txns

N

List<internal_txns>

Internal Txns

Transfer_logs || Internal_txns

Parameter
Required
Type
Description

from_address

N

String

From

to_address

N

String

To

token_address

N

String

Token's address or item contract address

value

N

String

value(wei)

Tips:

1.type is token,value means transaction volume (Unit: wei)

2.type is nft, value is the ID of item

3.type is approval, value is the quantity of authorization and approval or cancel approval

amount

N

BigDecimal

Quantity

usd_value

N

BigDecimal

USD Value

price

N

BigDecimal

price (when type is token)

direction

N

Integer

direction: 0: out / 1: in

type

N

String

token / nft / approval

Chain info

Parameter
Required
Type
Description

chain_id

Y

Long

Chain id

chain_name

Y

String

Chain name

scan_logo_url

Y

String

Chain scan logo

scan_tx_url

Y

String

Scan tx

logo_url

Y

String

Chain logo

native_token

Y

String

Native token

is_evm

Y

Int

If it's EVM chain ,0: True , 1: False

ABI info

Parameter
Required
Type
Description

method_id

N

String

Method ID

function_id

N

String

Function id

function_name

N

String

Function name

function_param

N

String

Function's param

Protocol info

Parameter
Required
Type
Description

chain_name

Y

String

Chain name

project_name

Y

String

Project's name

protocol_name

Y

String

Protocol's name

logo_url

N

String

Prorocol's logo

website_url

N

String

Protocol's website

contract_address

N

String

Contract address

tags

N

Map

Tags

Cex info

Parameter
Required
Type
Description

cex_id

Y

String

Cex id

contract_address

Y

String

Cex contract address

cex_name

N

String

Cex's name

logo_url

N

String

Protocol's logo

type

N

String

Vault, Deposit, Withdraw, Gastopup, Collect

Token(Token) Content

Parameter
Required
Type
Description

chain_name

Y

String

Chain

token_address

Y

String

Token's id

name

Y

String

Token's name

symbol

N

String

Token's symbol

decimal

N

Integer

Token's decimal

logo_url

N

String

Token's logo

token_type

N

String

Token type eg: ERC20

is_lp

N

String

If it's Liquidity Pool

tags

N

Map

Tags

Token(NFT) Content

Parameter
Required
Type
Description

chain_name

Y

String

Chain

id

Y

String

Primary key md5 (contract address+item id), 32-bit lowercase

image

N

String

URL of the item image

animation_url

N

String

URL of the item metadata animation

external_url

N

String

A link to additional information

contract_address

N

String

Contract address

item_id

N

String

Collection item id

amount

N

String

The amount of item

collection_address

N

String

Collection's address

attributes

N

String

Attributes

Collection(NFT) Content

Parameter
Required
Type
Description

chain_name

Y

String

Chain

contract_address

Y

String

Contract address

name

N

String

Collection's name

symbol

N

String

Collection's symbol

supply

N

String

Supply

logo_url

N

String

Collection's logo

banner_url

N

String

Collection's banner

is_core

N

Boolean

If it's core

is_scam

N

Boolean

If it's scam

is_verified

N

Boolean

If it's verified

Request Sample

curl https://api.blockin.ai/v2/user/history_list_pro -X POST -d '{"address":"0x50b42514389f25e1f471c8f03f6f5954df0204b0","chain_name":"eth","protocol_name":"uniswap2","start_time":0,"page_count":10}' -H "Content-Type:application/json" -H "AccessKey:1bdb01c947c54919b64d1fc6794atest"

Successful Response Sample

Last updated