Skip to main content

getnep17transfers Method

Returns all the NEP17 transaction information occurred in the specified address.

note

You must install the plugin TokensTracker, LevelDBStore, and RpcSever before you can invoke the method.

Parameter Description#

  • address: The address to query the transaction information.

  • startTime | endTime: Optional. The UTC timestamp which records the asset start or end time (included).

    • If start and end timestamps are specified, transactions occurred in the time range are returned.
    • If only one timestamp is specified, transactions occurred since that time are returned.
    • If not specified, transactions in recent seven days are returned.

Configuration#

Before invoking the method, you need to modify the following fields in the TokensTracker config.json file:

  • MaxResults: The maximum number of records. The exceeding portion will not be stored.
  • Network: Set it to the same value as Network in Neo-CLI config.json.

Example#

Example 1 - Set the start time#

Request body:

{  "jsonrpc": "2.0",  "method": "getnep17transfers",  "params": ["NikhQp1aAD1YFCiwknhM5LQQebj4464bCJ", 0],  "id": 1}

Response body:

{    "jsonrpc": "2.0",    "id": 1,    "result": {        "sent": [],        "received": [            {                "timestamp": 1612690497725,                "assethash": "0xf61eebf573ea36593fd43aa150c055ad7906ab83",                "transferaddress": "NgaiKFjurmNmiRzDRQGs44yzByXuSkdGPF",                "amount": "100",                "blockindex": 2,                "transfernotifyindex": 1,                "txhash": "0x5f957960a782514d6587c445288ee1cca7d6b0f952edc204f14d9be83b8152ff"            },            {                "timestamp": 1612690513541,                "assethash": "0x70e2301955bf1e74cbb31d18c2f96972abadb328",                "transferaddress": "NgaiKFjurmNmiRzDRQGs44yzByXuSkdGPF",                "amount": "10000000000",                "blockindex": 3,                "transfernotifyindex": 0,                "txhash": "0xe42108b343626035cb51fbcb54949bb38aac50c8ba278841d304e9fdce0807ac"            }        ],        "address": "NikhQp1aAD1YFCiwknhM5LQQebj4464bCJ"    }}

Example 2 - Set both timestamps#

Request body:

{    "jsonrpc": "2.0",    "method": "getnep17transfers",    "params": ["NikhQp1aAD1YFCiwknhM5LQQebj4464bCJ", 1611716619654, 2011716619654],    "id": 1}

Response body:

{    "jsonrpc": "2.0",    "id": 1,    "result": {        "sent": [],        "received": [            {                "timestamp": 1612690497725,                "assethash": "0xf61eebf573ea36593fd43aa150c055ad7906ab83",                "transferaddress": "NgaiKFjurmNmiRzDRQGs44yzByXuSkdGPF",                "amount": "100",                "blockindex": 2,                "transfernotifyindex": 1,                "txhash": "0x5f957960a782514d6587c445288ee1cca7d6b0f952edc204f14d9be83b8152ff"            },            {                "timestamp": 1612690513541,                "assethash": "0x70e2301955bf1e74cbb31d18c2f96972abadb328",                "transferaddress": "NgaiKFjurmNmiRzDRQGs44yzByXuSkdGPF",                "amount": "10000000000",                "blockindex": 3,                "transfernotifyindex": 0,                "txhash": "0xe42108b343626035cb51fbcb54949bb38aac50c8ba278841d304e9fdce0807ac"            }        ],        "address": "NikhQp1aAD1YFCiwknhM5LQQebj4464bCJ"    }}