Jump to
Ctrl
+
/

List Confirmed Tokens Transfers By Address And Time Range

GET
/blockchain-data/{blockchain}/{network}/addresses/{address}/tokens-transfers-by-time-range

Through this endpoint customers can obtain a list with confirmed token transfers by the address attribute and the query parameters fromTimestamp and toTimestamp which gives customers the opportunity to filter the results by a specified time period.

This refers only to transfers done for confirmed tokens not coins.

Path Parameters

blockchain string Required

Represents the specific blockchain protocol name, e.g. Ethereum, Ethereum Classic, etc.

network string Required

Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - "mainnet" is the live network with actual data while networks like "testnet", "sepolia" are test networks.

address string Required

Represents the public address, which is a compressed and shortened form of a public key.

Query Parameters

context string Optional

In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. context is specified by the user.

fromTimestamp integer Required

Defines the specific time/date from which the results will start being listed.

limit integer Optional

Defines how many items should be returned in the response per page basis.

Default : 50
offset integer Optional

The starting index of the response items, i.e. where the response should start listing the returned items.

Default : 0
toTimestamp integer Required

Defines the specific time/date to which the results will be listed.

Response Schema

apiVersion string Required

Specifies the version of the API that incorporates this endpoint.

2021-03-20
requestId string Required

Defines the ID of the request. The requestId is generated by Crypto APIs and it's unique for every request.

601c1710034ed6d407996b30
context string Optional

In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. context is specified by the user.

yourExampleString
data object Required
limit integer Required

Defines how many items should be returned in the response per page basis.

50
offset integer Required

The starting index of the response items, i.e. where the response should start listing the returned items.

0
total integer Required

Defines the total number of items returned in the response.

100
items array Items (object) Required
contractAddress string Required

Represents the contract address of the token, which controls its logic. It is not the address that holds the tokens.

0xdac17f958d2ee523a2206206994597c13d831ec7
minedInBlockHeight integer Required

Defines the block height in which this transaction was confirmed/mined.

12046964
recipientAddress string Required

Defines the address to which the recipient receives the transferred tokens.

0xdac17f958d2ee523a2206206994597c13d831ec7
senderAddress string Required

Defines the address from which the sender transfers tokens.

0x65b895f400dae5541d70cbbec07527210158f6e2
tokenDecimals integer Optional

Defines the decimals of the token, i.e. the number of digits that come after the decimal coma of the token.

6
tokenId string Optional

Represents the unique token identifier.

16721
tokenName string Optional

Defines the token's name as a string.

Tether USD
tokenSymbol string Optional

Defines the token symbol by which the token contract is known. It is usually 3-4 characters in length.

USDT
tokenType string Required

Defines the specific token type.

ERC-20
tokensAmount string Optional

Defines the token amount of the transfer.

9.146383
transactionHash string Required

Represents the hash of the transaction, which is its unique identifier. It represents a cryptographic digital fingerprint made by hashing the block header twice through the SHA256 algorithm.

0x32de09d747bcbed41e8162681a72b2a6c760cf2116ce372fcd357c260909838a
transactionTimestamp integer Required

Defines the specific time/date when the transaction was created in Unix Timestamp.

1615861410

Credits Cost : 500 Credits for 1 Results

Was this page helpful?
Yes
No
Language
URL

{
    "apiVersion": "2021-03-20",
    "requestId": "601c1710034ed6d407996b30",
    "context": "yourExampleString",
    "data": {
        "limit": 50,
        "offset": 0,
        "total": 100,
        "items": [
            {
                "contractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
                "minedInBlockHeight": 12046964,
                "recipientAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
                "senderAddress": "0x65b895f400dae5541d70cbbec07527210158f6e2",
                "tokenDecimals": 6,
                "tokenId": "16721",
                "tokenName": "Tether USD",
                "tokenSymbol": "USDT",
                "tokenType": "ERC-20",
                "tokensAmount": "9.146383",
                "transactionHash": "0x32de09d747bcbed41e8162681a72b2a6c760cf2116ce372fcd357c260909838a",
                "transactionTimestamp": 1615861410
            }
        ]
    }
}