Transactions Query Language

To expand opportunities of getting transactions use parametres to filter results, and options.

Available filters (may be specific to endpoint):

• blockId
• fromHeight
• toHeight
• minAmount
• maxAmount
• senderId
• recipientId
• inId
• type
• key

Filters available for endponts:

• /api/transactions: blockId, fromHeight, toHeight, minAmount, maxAmount, senderId, recipientId, inId, type
• /api/chats/get: fromHeight, toHeight, senderId, recipientId, inId, type
• /api/chatrooms: type
• /api/states/get: fromHeight, toHeight, senderId, key, type

You can use limit, offset, orderBy and withoutDirectTransfers options.

Filters and options can be joined: Combine filters and options.

Available filter parameters

blockId

Get transactions in specific block.

Example: http://endless.adamant.im/api/transactions?blockId=7917597195203393333

fromHeight

Get transactions starting from block with specific height.

Example: http://endless.adamant.im/api/transactions?fromHeight=10336065

toHeight

Get transactions till block with specific height.

Example: http://endless.adamant.im/api/transactions?toHeight=11

minAmount

Get transactions with amount not less than specified Integer value of 1/10^8 tokens (1 ADM = 100000000).

Example: http://endless.adamant.im/api/transactions?minAmount=1000000000000001

maxAmount

Get transactions with amount not more than specified Integer value of 1/10^8 tokens (1 ADM = 100000000).

Example: http://endless.adamant.im/api/transactions?maxAmount=50000000

senderId

Get transactions sent from specified ADAMANT address.

Example: https://endless.adamant.im/api/transactions?senderId=U15423595369615486571

recipientId

Get transactions received by specified ADAMANT address.

Example: https://endless.adamant.im/api/transactions?recipientId=U15423595369615486571

inId

Get transactions sent from or received to specified ADAMANT address.

Example: http://endless.adamant.im/api/transactions?inId=U100739400829575109

type

Parameter meaning depends on enpoint:

• /api/transactions: Get transactions of specified type. See Transactions Types. If type is not set, all types of transactions will be returned.
• /api/chats/get and /api/chatrooms: Get messages of specified type. See ADAMANT messages types. If type is not set, all types of messages will be returned.
• /api/states/get: Get KVS records of incremental or full re-write of previous values. Default is 0. See AIP 11: Behavior for KVS data.

Example: https://endless.adamant.im/api/transactions?type=8

Example: https://endless.adamant.im/api/chats/get?type=2

Example: https://endless.adamant.im/api/chatrooms/U17362714543155685887/U17819800352812315500?type=2

key

Refers to /api/states/get endpoint.

Get transactions of specified KVS key. See AIP 3: Storing data in chain (KVS).

Example: https://endless.adamant.im/api/states/get?key=eth:address

Available options

Options can be combined.

limit

Limits returned items count. Default is 100 for transactions and 25 for chatrooms.

Example: https://endless.adamant.im/api/transactions?limit=2

offset

Offset value for results, integer. Default is 0.

Example: https://endless.adamant.im/api/transactions?offset=100

orderBy

Ordering request results by fieldname.

Example: https://endless.adamant.im/api/transactions?orderBy=timestamp:desc

withoutDirectTransfers

When set to true, excludes type 0 transactions (direct token transfers) from results. Default is false.

NOTE: Available for /api/chatrooms endpont only.

Example: https://endless.adamant.im/api/chatrooms/U2707535059340134112?withoutDirectTransfers=true

Combine filters and options

You can filter by single parameter, or by multiple parameters. Default condition and or or differs for endpoint:

• /api/transactions: default is or; to set and use and:
• /api/chats/get: default is and
• /api/chatrooms: default is and
• /api/states/get: default is and

Options always joined with and condition.

Examples:

https://endless.adamant.im/api/transactions?fromHeight=1336065&blockId=7917597195203393333

Get transactions where height greater than 1336065 or blockId = 7917597195203393333.

https://endless.adamant.im/api/transactions?fromHeight=1336065&and:senderId=U15423595369615486571&limit=2&orderBy=timestamp:asc

Get transactions where height greater than 1336065 and senderId = U15423595369615486571, order by timestamp ascending and limit results by 2 transactions.