Skip to main content

/api/v1/contracts REST API Endpoint

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

Updated on
Aug 23, 2024

/api/v1/contracts REST API Endpoint

Please note that this method is currently available only on the testnet and will be accessible on the mainnet soon.

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
The administrative key for the contract, if any
_type
string
The type of key
key
string
The key value
auto_renew_account
string
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
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
The account ID of the obtainer
permanent_removal
boolean
Indicates if the contract is marked for permanent removal.
proxy_account_id
string
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
The ending timestamp of the contract's activity
links
object
An object containing pagination links
next
string
A URL to fetch the next set of results, if available
Request
1
curl 'https://docs-demo.hedera-mainnet.quiknode.pro/api/v1/contracts'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free