Transactions Query Language

adm get transactions <query> accepts URL-style transaction query fragments and forwards them to ADAMANT Node through adamant-api.

adm get transactions senderId=U123456789
adm get transactions recipientId=U123456789,limit=10
adm get transactions 'types=0&orderBy=timestamp:desc&returnUnconfirmed=1'

Use , or & to combine query parameters. Console uses adamant-api v3 transaction-query semantics: top-level transaction filters are combined with AND by default. Prefix filters with or: only when you need an OR group. The and: prefix is still accepted for compatibility, but it is no longer required for normal multi-filter queries.

adm get transactions 'senderId=U123456789,recipientId=U987654321'
adm get transactions 'or:senderId=U123456789,or:recipientId=U987654321'

Common options such as limit, offset, orderBy, returnUnconfirmed, returnAsset, includeDirectTransfers, and userId are passed as request options, not logical filters.

Transaction Filters

Parameter	Purpose
blockId	Match transactions in a block
fromHeight	Match transactions from a starting block height
toHeight	Match transactions up to an ending block height
minAmount	Match transactions whose amount is not less than the value
maxAmount	Match transactions whose amount is not greater than the value
senderId	Match transactions sent by an ADAMANT address
recipientId	Match transactions sent to an ADAMANT address
inId	Match transactions where the address is sender or recipient
type	Match one transaction type
types	Match one or more transaction types when supported by the node API
returnUnconfirmed	Include unconfirmed transaction data when supported by the node API

Amounts are integer ADM atoms. 1 ADM equals 100000000.

Transaction type 0 is a token transfer. Transaction type 8 is a chat message or in-chat transfer. For protocol-level type definitions, see AIP-10 transaction types.

Block Filters

adm get blocks <query> accepts block query parameters:

Parameter	Purpose
blockId	Match a block by ID
generatorPublicKey	Match blocks forged by a delegate public key
height	Match a block by height
limit	Limit the number of returned records
offset	Skip records before returning results
orderBy	Sort by a field, for example height:desc

Common Options

Option	Purpose
limit	Limit returned record count
offset	Skip records before returning results
orderBy	Sort by a field and direction, for example timestamp:desc

Examples

Transactions involving one address, ordered newest first:

adm get transactions 'inId=U123456789,minAmount=1,orderBy=timestamp:desc'

Last token transfer involving one address:

adm get transactions 'inId=U123456789,type=0,limit=1,orderBy=timestamp:desc'

Transactions in a block sent to a specific recipient:

adm get transactions 'blockId=7917597195203393333,recipientId=U123456789,orderBy=timestamp:asc'

The compatibility form with and:recipientId is also accepted and is converted before calling adamant-api.

Last 100 transactions sent to one recipient:

adm get transactions 'recipientId=U123456789,orderBy=timestamp:desc,limit=100'