Skip to main content

/api/v1/contracts REST API Endpoint

Returns a list of all contract entity items on the network.

Updated on
Dec 18, 2024

Query Parameters

contract.id
string

The ID of the smart contract

limit
integer

The maximum number of items to return

order
string

The order in which items are listed (asc or desc)

Returns

contracts
array

An array of objects, each representing a contract on the Hedera network

admin_key
object | null

The administrative key for the contract, if any

_type
string

The type of key

key
string

The key value

auto_renew_account
string | null

The account ID to charge for auto-renewal of the contract

auto_renew_period
integer

The period in seconds for auto-renewal of the contract

contract_id
string

The unique identifier of the contract

created_timestamp
string

The timestamp when the contract was created

deleted
boolean

A boolean indicating whether the contract has been deleted

evm_address
string

The Ethereum Virtual Machine (EVM) address of the contract

expiration_timestamp
string

The timestamp when the contract is set to expire

max_automatic_token_associations
integer

The maximum number of automatic token associations for the contract

file_id
string | null

The file ID associated with the contract

memo
string

A memo associated with the contract

nonce
integer

The nonce value for the contract, indicating the number of transactions sent

obtainer_id
string | null

The account ID of the obtainer

permanent_removal
boolean | null

Indicates if the contract is marked for permanent removal.

proxy_account_id
string | null

The proxy account ID for the contract, if any

timestamp
object

An object indicating the time range during which the contract is active

from
string

The starting timestamp of the contract's activity

to
string | null

The ending timestamp of the contract's activity

links
object

An object containing pagination links

next
string | null

A URL to fetch the next set of results, if available

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free