v1

latestOpenAPI 3.0.02026-07-17506168.4 KB

contracts

Query contracts

Queries v1 contracts matching the provided filter and returns a paginated result.

post/contracts

statusesstring[]

Filter by contract statuses.

contractIDsFileContractID[]

Filter by specific contract IDs.

renewedFromFileContractID[]

Filter by the contract ID this contract was renewed from.

renewedToFileContractID[]

Filter by the contract ID this contract was renewed to.

renterKeyPublicKey[]

Filter by renter public keys.

minNegotiationHeightinteger

Minimum block height at which the contract was negotiated.

maxNegotiationHeightinteger

Maximum block height at which the contract was negotiated.

minExpirationHeightinteger

Minimum contract expiration block height.

maxExpirationHeightinteger

Maximum contract expiration block height.

limitinteger

Maximum number of contracts to return per page. Defaults to 100.

offsetinteger

Number of contracts to skip for pagination.

sortFieldstring

Field to sort results by. Valid values are "status", "negotiationHeight", "expirationHeight".

sortDescboolean

Sort in descending order when true.

Contracts matching filter.

countinteger required

Total number of contracts matching the filter.

contractsContract[] required

Contracts matching the filter for the current page.