Operations

Get originations

Returns a list of origination operations.

get/v1/operations/originations

Query parameters

eqstring nullable

Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify a value to get items where any of the specified fields is equal to the specified value.

Example: ?anyof.sender.target=tz1WnfXMPaNTBmH7DBPwqCWs9cPDJdkGBTZ8.

instring[] nullable

In list (any of) filter mode.
Specify a comma-separated list of values to get items where any of the specified fields is equal to one of the specified values.

Example: ?anyof.sender.target.in=tz1WnfXMPaNTBWnfXMPaNTBWnfXMPaNTBNTB,tz1SiPXX4MYGNJNDSiPXX4MYGNJNDSiPXX4M,null.

nullboolean nullable

Is null filter mode.
Use this mode to get items where any of the specified fields is null or not.

Example: ?anyof.from.to.null or ?anyof.from.to.null=false.

Filters originations by any of the specified fields. Example: anyof.sender.initiator=tz1... will return operations where sender OR initiator is equal to the specified value. This parameter is useful when you need to retrieve all originations associated with a specified account.

eqstring nullable

Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify a tz or KT address to get items where the specified field is equal to the specified value.

Example: ?sender=tz1WnfXMPaNTBmH7DBPwqCWs9cPDJdkGBTZ8.

nestring nullable

Not equal filter mode.
Specify a tz or KT address to get items where the specified field is not equal to the specified value.

Example: ?sender.ne=tz1WnfXMPaNTBmH7DBPwqCWs9cPDJdkGBTZ8.

instring[] nullable

In list (any of) filter mode.
Specify a comma-separated list of addresses to get items where the specified field is equal to one of the specified values.

Example: ?sender.in=tz1WnfXMPaNTBWnfXMPaNTBWnfXMPaNTBNTB,tz1SiPXX4MYGNJNDSiPXX4MYGNJNDSiPXX4M.

nistring[] nullable

Not in list (none of) filter mode.
Specify a comma-separated list of addresses to get items where the specified field is not equal to all the specified values.

Example: ?sender.ni=tz1WnfXMPaNTBWnfXMPaNTBWnfXMPaNTBNTB,tz1SiPXX4MYGNJNDSiPXX4MYGNJNDSiPXX4M.

eqxstring nullable

Equal to another field filter mode.
Specify a field name to get items where the specified fields are equal.

Example: ?sender.eqx=target.

nexstring nullable

Not equal to another field filter mode.
Specify a field name to get items where the specified fields are not equal.

Example: ?sender.nex=initiator.

nullboolean nullable

Is null filter mode.
Use this mode to get items where the specified field is null or not.

Example: ?initiator.null or ?initiator.null=false.

Filters origination operations by initiator. Allowed fields for .eqx mode: contractDelegate.

eqstring nullable

Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify a tz or KT address to get items where the specified field is equal to the specified value.

Example: ?sender=tz1WnfXMPaNTBmH7DBPwqCWs9cPDJdkGBTZ8.

nestring nullable

Not equal filter mode.
Specify a tz or KT address to get items where the specified field is not equal to the specified value.

Example: ?sender.ne=tz1WnfXMPaNTBmH7DBPwqCWs9cPDJdkGBTZ8.

instring[] nullable

In list (any of) filter mode.
Specify a comma-separated list of addresses to get items where the specified field is equal to one of the specified values.

Example: ?sender.in=tz1WnfXMPaNTBWnfXMPaNTBWnfXMPaNTBNTB,tz1SiPXX4MYGNJNDSiPXX4MYGNJNDSiPXX4M.

nistring[] nullable

Not in list (none of) filter mode.
Specify a comma-separated list of addresses to get items where the specified field is not equal to all the specified values.

Example: ?sender.ni=tz1WnfXMPaNTBWnfXMPaNTBWnfXMPaNTBNTB,tz1SiPXX4MYGNJNDSiPXX4MYGNJNDSiPXX4M.

eqxstring nullable

Equal to another field filter mode.
Specify a field name to get items where the specified fields are equal.

Example: ?sender.eqx=target.

nexstring nullable

Not equal to another field filter mode.
Specify a field name to get items where the specified fields are not equal.

Example: ?sender.nex=initiator.

nullboolean nullable

Is null filter mode.
Use this mode to get items where the specified field is null or not.

Example: ?initiator.null or ?initiator.null=false.

Filters origination operations by sender. Allowed fields for .eqx mode: contractDelegate.

eqstring nullable

Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify a tz or KT address to get items where the specified field is equal to the specified value.

Example: ?sender=tz1WnfXMPaNTBmH7DBPwqCWs9cPDJdkGBTZ8.

nestring nullable

Not equal filter mode.
Specify a tz or KT address to get items where the specified field is not equal to the specified value.

Example: ?sender.ne=tz1WnfXMPaNTBmH7DBPwqCWs9cPDJdkGBTZ8.

instring[] nullable

In list (any of) filter mode.
Specify a comma-separated list of addresses to get items where the specified field is equal to one of the specified values.

Example: ?sender.in=tz1WnfXMPaNTBWnfXMPaNTBWnfXMPaNTBNTB,tz1SiPXX4MYGNJNDSiPXX4MYGNJNDSiPXX4M.

nistring[] nullable

Not in list (none of) filter mode.
Specify a comma-separated list of addresses to get items where the specified field is not equal to all the specified values.

Example: ?sender.ni=tz1WnfXMPaNTBWnfXMPaNTBWnfXMPaNTBNTB,tz1SiPXX4MYGNJNDSiPXX4MYGNJNDSiPXX4M.

eqxstring nullable

Equal to another field filter mode.
Specify a field name to get items where the specified fields are equal.

Example: ?sender.eqx=target.

nexstring nullable

Not equal to another field filter mode.
Specify a field name to get items where the specified fields are not equal.

Example: ?sender.nex=initiator.

nullboolean nullable

Is null filter mode.
Use this mode to get items where the specified field is null or not.

Example: ?initiator.null or ?initiator.null=false.

Filters origination operations by delegate. Allowed fields for .eqx mode: initiator, sender.

eqstring nullable

Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify a tz or KT address to get items where the specified field is equal to the specified value.

Example: ?sender=tz1WnfXMPaNTBmH7DBPwqCWs9cPDJdkGBTZ8.

nestring nullable

Not equal filter mode.
Specify a tz or KT address to get items where the specified field is not equal to the specified value.

Example: ?sender.ne=tz1WnfXMPaNTBmH7DBPwqCWs9cPDJdkGBTZ8.

instring[] nullable

In list (any of) filter mode.
Specify a comma-separated list of addresses to get items where the specified field is equal to one of the specified values.

Example: ?sender.in=tz1WnfXMPaNTBWnfXMPaNTBWnfXMPaNTBNTB,tz1SiPXX4MYGNJNDSiPXX4MYGNJNDSiPXX4M.

nistring[] nullable

Not in list (none of) filter mode.
Specify a comma-separated list of addresses to get items where the specified field is not equal to all the specified values.

Example: ?sender.ni=tz1WnfXMPaNTBWnfXMPaNTBWnfXMPaNTBNTB,tz1SiPXX4MYGNJNDSiPXX4MYGNJNDSiPXX4M.

eqxstring nullable

Equal to another field filter mode.
Specify a field name to get items where the specified fields are equal.

Example: ?sender.eqx=target.

nexstring nullable

Not equal to another field filter mode.
Specify a field name to get items where the specified fields are not equal.

Example: ?sender.nex=initiator.

nullboolean nullable

Is null filter mode.
Use this mode to get items where the specified field is null or not.

Example: ?initiator.null or ?initiator.null=false.

Filters origination operations by originated contract. Allowed fields for .eqx mode: none.

eqinteger nullable

Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify an integer number to get items where the specified field is equal to the specified value.

Example: ?balance=1234.

neinteger nullable

Not equal filter mode.
Specify an integer number to get items where the specified field is not equal to the specified value.

Example: ?balance.ne=1234.

gtinteger nullable

Greater than filter mode.
Specify an integer number to get items where the specified field is greater than the specified value.

Example: ?balance.gt=1234.

geinteger nullable

Greater or equal filter mode.
Specify an integer number to get items where the specified field is greater than equal to the specified value.

Example: ?balance.ge=1234.

ltinteger nullable

Less than filter mode.
Specify an integer number to get items where the specified field is less than the specified value.

Example: ?balance.lt=1234.

leinteger nullable

Less or equal filter mode.
Specify an integer number to get items where the specified field is less than or equal to the specified value.

Example: ?balance.le=1234.

ininteger[] nullable

In list (any of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is equal to one of the specified values.

Example: ?level.in=12,14,52,69.

niinteger[] nullable

Not in list (none of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is not equal to all the specified values.

Example: ?level.ni=12,14,52,69.

emptyboolean

Filters origination operations by internal TzKT id

eqinteger nullable

Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify an integer number to get items where the specified field is equal to the specified value.

Example: ?balance=1234.

neinteger nullable

Not equal filter mode.
Specify an integer number to get items where the specified field is not equal to the specified value.

Example: ?balance.ne=1234.

gtinteger nullable

Greater than filter mode.
Specify an integer number to get items where the specified field is greater than the specified value.

Example: ?balance.gt=1234.

geinteger nullable

Greater or equal filter mode.
Specify an integer number to get items where the specified field is greater than equal to the specified value.

Example: ?balance.ge=1234.

ltinteger nullable

Less than filter mode.
Specify an integer number to get items where the specified field is less than the specified value.

Example: ?balance.lt=1234.

leinteger nullable

Less or equal filter mode.
Specify an integer number to get items where the specified field is less than or equal to the specified value.

Example: ?balance.le=1234.

ininteger[] nullable

In list (any of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is equal to one of the specified values.

Example: ?level.in=12,14,52,69.

niinteger[] nullable

Not in list (none of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is not equal to all the specified values.

Example: ?level.ni=12,14,52,69.

Filters origination operations by 32-bit hash of originated contract parameter and storage types (helpful for searching originations of similar contracts)

eqinteger nullable

Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify an integer number to get items where the specified field is equal to the specified value.

Example: ?balance=1234.

neinteger nullable

Not equal filter mode.
Specify an integer number to get items where the specified field is not equal to the specified value.

Example: ?balance.ne=1234.

gtinteger nullable

Greater than filter mode.
Specify an integer number to get items where the specified field is greater than the specified value.

Example: ?balance.gt=1234.

geinteger nullable

Greater or equal filter mode.
Specify an integer number to get items where the specified field is greater than equal to the specified value.

Example: ?balance.ge=1234.

ltinteger nullable

Less than filter mode.
Specify an integer number to get items where the specified field is less than the specified value.

Example: ?balance.lt=1234.

leinteger nullable

Less or equal filter mode.
Specify an integer number to get items where the specified field is less than or equal to the specified value.

Example: ?balance.le=1234.

ininteger[] nullable

In list (any of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is equal to one of the specified values.

Example: ?level.in=12,14,52,69.

niinteger[] nullable

Not in list (none of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is not equal to all the specified values.

Example: ?level.ni=12,14,52,69.

Filters origination operations by 32-bit hash of originated contract code (helpful for searching originations of same contracts)

eqinteger nullable

Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify an integer number to get items where the specified field is equal to the specified value.

Example: ?balance=1234.

neinteger nullable

Not equal filter mode.
Specify an integer number to get items where the specified field is not equal to the specified value.

Example: ?balance.ne=1234.

gtinteger nullable

Greater than filter mode.
Specify an integer number to get items where the specified field is greater than the specified value.

Example: ?balance.gt=1234.

geinteger nullable

Greater or equal filter mode.
Specify an integer number to get items where the specified field is greater than equal to the specified value.

Example: ?balance.ge=1234.

ltinteger nullable

Less than filter mode.
Specify an integer number to get items where the specified field is less than the specified value.

Example: ?balance.lt=1234.

leinteger nullable

Less or equal filter mode.
Specify an integer number to get items where the specified field is less than or equal to the specified value.

Example: ?balance.le=1234.

ininteger[] nullable

In list (any of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is equal to one of the specified values.

Example: ?level.in=12,14,52,69.

niinteger[] nullable

Not in list (none of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is not equal to all the specified values.

Example: ?level.ni=12,14,52,69.

Filters origination operations by level.

eqstring date-time nullable

Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify a datetime value to get items where the specified field is equal to the specified value.

Example: ?timestamp=2020-02-20T02:40:57Z.

nestring date-time nullable

Not equal filter mode.
Specify a datetime value to get items where the specified field is not equal to the specified value.

Example: ?timestamp.ne=2020-02-20T02:40:57Z.

gtstring date-time nullable

Greater than filter mode.
Specify a datetime value to get items where the specified field is greater than the specified value.

Example: ?timestamp.gt=2020-02-20T02:40:57Z.

gestring date-time nullable

Greater or equal filter mode.
Specify a datetime value to get items where the specified field is greater than equal to the specified value.

Example: ?timestamp.ge=2020-02-20T02:40:57Z.

ltstring date-time nullable

Less than filter mode.
Specify a datetime value to get items where the specified field is less than the specified value.

Example: ?timestamp.lt=2020-02-20T02:40:57Z.

lestring date-time nullable

Less or equal filter mode.
Specify a datetime value to get items where the specified field is less than or equal to the specified value.

Example: ?timestamp.le=2020-02-20T02:40:57Z.

instring[] nullable

In list (any of) filter mode.
Specify a comma-separated list of datetimes to get items where the specified field is equal to one of the specified values.

Example: ?timestamp.in=2020-02-20,2020-02-21.

nistring[] nullable

Not in list (none of) filter mode.
Specify a comma-separated list of datetimes to get items where the specified field is not equal to all the specified values.

Example: ?timestamp.ni=2020-02-20,2020-02-21.

Filters origination operations by timestamp.

eqinteger nullable

Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify an integer number to get items where the specified field is equal to the specified value.

Example: ?balance=1234.

neinteger nullable

Not equal filter mode.
Specify an integer number to get items where the specified field is not equal to the specified value.

Example: ?balance.ne=1234.

gtinteger nullable

Greater than filter mode.
Specify an integer number to get items where the specified field is greater than the specified value.

Example: ?balance.gt=1234.

geinteger nullable

Greater or equal filter mode.
Specify an integer number to get items where the specified field is greater than equal to the specified value.

Example: ?balance.ge=1234.

ltinteger nullable

Less than filter mode.
Specify an integer number to get items where the specified field is less than the specified value.

Example: ?balance.lt=1234.

leinteger nullable

Less or equal filter mode.
Specify an integer number to get items where the specified field is less than or equal to the specified value.

Example: ?balance.le=1234.

ininteger[] nullable

In list (any of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is equal to one of the specified values.

Example: ?level.in=12,14,52,69.

niinteger[] nullable

Not in list (none of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is not equal to all the specified values.

Example: ?level.ni=12,14,52,69.

Filters by senderCodeHash.

eqinteger nullable

Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify an integer number to get items where the specified field is equal to the specified value.

Example: ?balance=1234.

neinteger nullable

Not equal filter mode.
Specify an integer number to get items where the specified field is not equal to the specified value.

Example: ?balance.ne=1234.

gtinteger nullable

Greater than filter mode.
Specify an integer number to get items where the specified field is greater than the specified value.

Example: ?balance.gt=1234.

geinteger nullable

Greater or equal filter mode.
Specify an integer number to get items where the specified field is greater than equal to the specified value.

Example: ?balance.ge=1234.

ltinteger nullable

Less than filter mode.
Specify an integer number to get items where the specified field is less than the specified value.

Example: ?balance.lt=1234.

leinteger nullable

Less or equal filter mode.
Specify an integer number to get items where the specified field is less than or equal to the specified value.

Example: ?balance.le=1234.

ininteger[] nullable

In list (any of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is equal to one of the specified values.

Example: ?level.in=12,14,52,69.

niinteger[] nullable

Not in list (none of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is not equal to all the specified values.

Example: ?level.ni=12,14,52,69.

Filters by either senderCodeHash or codeHash.

eqstring nullable

Equal filter mode (optional, i.e. param.eq=applied is the same as param=applied).
Specify an operation status to get items where the specified field is equal to the specified value.

Example: ?type=failed.

nestring nullable

Not equal filter mode.
Specify an operation status to get items where the specified field is not equal to the specified value.

Example: ?type.ne=applied.

Filters origination operations by operation status (applied, failed, backtracked, skipped).

fieldsstring[] nullable

Fields selection mode (optional, i.e. select.fields=balance is the same as select=balance).
Specify a comma-separated list of fields to include into response.

Example: ?select=address,balance => [ { "address": "asd", "balance": 10 } ].

valuesstring[] nullable

Values selection mode.
Specify a comma-separated list of fields to include their values into response.

Example: ?select.values=address,balance => [ [ "asd", 10 ] ].

Specify comma-separated list of fields to include into response or leave it undefined to return full object. If you select single field, response will be an array of values in both .fields and .values modes.

ascstring nullable

Ascending sort mode (optional, i.e. sort.asc=id is the same as sort=id).
Specify a field name to sort by.

Example: ?sort=balance.

descstring nullable

Descending sort mode.
Specify a field name to sort by descending.

Example: ?sort.desc=id.

Sorts originations by specified field. Supported fields: id (default), level, gasUsed, storageUsed, bakerFee, storageFee, allocationFee, contractBalance.

elinteger nullable

Elements offset mode (optional, i.e. offset.el=123 is the same as offset=123).
Skips specified number of elements.

Example: ?offset=100.

pginteger nullable

Page offset mode.
Skips page * limit elements. This is a classic pagination.

Example: ?offset.pg=1.

crinteger nullable

Cursor offset mode.
Skips all elements with the cursor before (including) the specified value. Cursor is a field used for sorting, e.g. id. Avoid using this offset mode with non-unique or non-sequential cursors such as amount, balance, etc.

Example: ?offset.cr=45837.

Specifies which or how many items should be skipped

limitinteger

Maximum number of items to return

micheline'Json' | 'JsonString' | 'Raw' | 'RawString'

Format of the parameters, storage and diffs: 0 - JSON, 1 - JSON string, 2 - raw micheline, 3 - raw micheline string

quote'None' | 'Btc' | 'Eur' | 'Usd' | 'Cny' | 'Jpy' | 'Krw' | 'Eth' | 'Gbp'

Comma-separated list of ticker symbols to inject historical prices into response

Response

typestring

Type of the operation, origination - deployment / contract creation operation.

idinteger

Unique ID of the operation, stored in the TzKT indexer database

levelinteger

The height of the block from the genesis block, in which the operation was included

timestampstring date-time

Datetime of the block, in which the operation was included (ISO 8601, e.g. 2020-02-20T02:40:57Z)

blockstring required

Hash of the block, in which the operation was included

hashstring required

Hash of the operation

counterinteger

An account nonce which is used to prevent operation replay

senderCodeHashinteger nullable

Hash of the sender contract code, or null is the sender is not a contract

nonceinteger nullable

An account nonce which is used to prevent internal operation replay

gasLimitinteger

A cap on the amount of gas a given operation can consume

gasUsedinteger

Amount of gas, consumed by the operation

storageLimitinteger

A cap on the amount of storage a given operation can consume

storageUsedinteger

Amount of storage, consumed by the operation

bakerFeeinteger

Fee to the baker, produced block, in which the operation was included (micro tez)

storageFeeinteger

The amount of funds burned from the sender account for contract storage in the blockchain (micro tez)

allocationFeeinteger

The amount of funds burned from the sender account for contract account creation (micro tez)

contractBalanceinteger

The contract origination balance (micro tez)

{"stackTrail":"components:schemas:OriginationOperation:allOf:properties:code","oasType":"schema","type":"unknown","description":"Contract code. Note: you can configure code format by setting `micheline` query parameter (`0 | 2` - raw micheline, `1 | 3` - raw micheline string).","nullable":true}

{"stackTrail":"components:schemas:OriginationOperation:allOf:properties:storage","oasType":"schema","type":"unknown","description":"Initial contract storage value converted to human-readable JSON. Note: you can configure storage format by setting `micheline` query parameter.","nullable":true}

statusstring required

Operation status (applied - an operation applied by the node and successfully added to the blockchain, failed - an operation which failed with some particular error (not enough balance, gas limit, etc), backtracked - an operation which was a successful but reverted due to one of the following operations in the same operation group was failed, skipped - all operations after the failed one in an operation group)

tokenTransfersCountinteger nullable

Number of token transfers produced by the operation, or null if there are no transfers

Changes

No recorded changes to this endpoint across all 1 revision of this API.