Get proposals
Returns a list of proposal operations.
Query parameters
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.
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.
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.
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.
Equal to another field filter mode.
Specify a field name to get items where the specified fields are equal.
Example: ?sender.eqx=target.
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.
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 proposal operations by delegate. Allowed fields for .eqx mode: none.
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.
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.
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.
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.
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.
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.
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.
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 proposal operations by level.
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.
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.
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.
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.
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.
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.
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.
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 proposal operations by timestamp.
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.
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.
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.
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.
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.
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.
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.
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 proposal operations by voting epoch.
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.
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.
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.
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.
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.
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.
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.
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 proposal operations by voting period.
Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify a protocol hash to get items where the specified field is equal to the specified value.
Example: ?protocol=PsCARTHAGaz....
Not equal filter mode.
Specify a protocol hash to get items where the specified field is not equal to the specified value.
Example: ?sender.ne=PsBabyM1eUX....
In list (any of) filter mode.
Specify a comma-separated list of protocol hashes to get items where the specified field is equal to one of the specified values.
Example: ?sender.in=PsCARTHAGaz,PsBabyM1eUX.
Not in list (none of) filter mode.
Specify a comma-separated list of protocol hashes to get items where the specified field is not equal to all the specified values.
Example: ?sender.ni=PsCARTHAGaz,PsBabyM1eUX.
Filters proposal operations by proposal hash.
Equal filter mode (optional, i.e. param.eq=true is the same as param=true).
Specify a bool flag to get items where the specified field is equal to the specified value.
Example: ?active=true or ?active=1 or ?active.
Is null filter mode.
Use this mode to get items where the specified field is null or not.
Example: ?active.null or ?active.null=false.
Specify whether to include or exclude duplicates, which didn't actually upvote a proposal.
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 } ].
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.
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.
Descending sort mode.
Specify a field name to sort by descending.
Example: ?sort.desc=id.
Sorts proposal operations by specified field. Supported fields: id (default), level.
Elements offset mode (optional, i.e. offset.el=123 is the same as offset=123).
Skips specified number of elements.
Example: ?offset=100.
Page offset mode.
Skips page * limit elements. This is a classic pagination.
Example: ?offset.pg=1.
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
Maximum number of items to return
Comma-separated list of ticker symbols to inject historical prices into response
Response
Type of the operation, proposal - is used by bakers (delegates) to submit and/or upvote proposals to amend the protocol
Unique ID of the operation, stored in the TzKT indexer database
The height of the block from the genesis block, in which the operation was included
Datetime of the block, in which the operation was included (ISO 8601, e.g. 2020-02-20T02:40:57Z)
Hash of the block, in which the operation was included
Hash of the operation
Baker's voting power
Indicates whether proposal upvote has already been pushed. Duplicated proposal operations are not counted when selecting proposal-winner.
Changes
No recorded changes to this endpoint across all 1 revision of this API.