How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Hedera

Hedera Contracts API

The contracts objects represents the information associated with contract entities.The contracts list endpoint is cached and not updated as frequently as the contract lookup by a specific ID endpoint.

Documentation Provider Profile APIs.io OpenAPI GitHub

Hedera Contracts API is one of 10 APIs that Hedera publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Contracts. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and rate-limit docs.

This API exposes 12 operations across 12 paths, and defines 38 schemas. It is described by OpenAPI 3.2.0, at version 0.156.0.

Requests are made against a single base URL, {scheme}://{network}.mirrornode.hedera.com.

12 operations 12 paths 38 schemas 11 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
0.156.0
Base URL
https://mainnet.mirrornode.hedera.com
Contact
Mirror Node Team
License
Apache-2.0
Resource Areas
1

Paths & Operations 12

Across 12 paths, the API surfaces 12 operations — 11 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Contracts 12

The contracts objects represents the information associated with contract entities.The contracts list endpoint is cached and not updated as frequently as the contract lookup by a…

POST
/api/v1/contracts/call
Invoke a smart contract
contractCall body → 200400404415429500501
GET
/api/v1/contracts
List contract entities on network
getContracts 3 params → 200400
GET
/api/v1/contracts/{contractIdOrAddress}
Get contract by id
getContract 2 params → 200400404
GET
/api/v1/contracts/{contractIdOrAddress}/results
List contract results from a contract on the network
getContractResultsByContractId 9 params → 200400
GET
/api/v1/contracts/{contractIdOrAddress}/state
The contract state from a contract on the network
getContractState 5 params → 200400
GET
/api/v1/contracts/{contractIdOrAddress}/results/{timestamp}
Get the contract result from a contract on the network executed at a given…
getContractResultByIdAndTimestamp 3 params → 200206400404
GET
/api/v1/contracts/results
List contract results from all contracts on the network
getContractsResults 9 params → 200400
GET
/api/v1/contracts/results/{transactionIdOrHash}
Get the contract result from a contract on the network for a given…
getContractResultByTransactionIdOrHash 3 params → 200206400404
GET
/api/v1/contracts/results/{transactionIdOrHash}/actions
Get the contract actions from a contract on the network for a given…
getContractActions 4 params → 200400404
GET
/api/v1/contracts/results/{transactionIdOrHash}/opcodes
Get the opcode traces for a historical transaction on the network with the…
getContractOpcodes 4 params → 200400404429
GET
/api/v1/contracts/{contractIdOrAddress}/results/logs
List contract logs from a contract on the network
getContractLogsByContractId 9 params → 200400
GET
/api/v1/contracts/results/logs
List contracts logs across many contracts on the network
getContractsLogs 9 params → 200400

Schemas 38

The contract defines 38 schemas that model the data the API accepts and returns. The most detailed are ContractResult (33 properties), ContractAction (17 properties), Contract (16 properties), Opcode (9 properties). Each schema is shown below with its type and property counts.

OpcodesResponse
object
6 properties 6 required
ContractLogTopics
array
A list of hex encoded topics associated with this log event
ContractCallResponse
object
1 property
ContractCallRequest
object
8 properties 1 required
ContractResults
array
ContractActionsResponse
object
2 properties
ContractResult
object
33 properties
ContractResponse
ContractStateResponse
object
2 properties
Timestamp
string
A Unix timestamp in seconds.nanoseconds format
EntityId
stringnull
Network entity ID in the format of shard.realm.num
AuthorizationList
object
6 properties
Bloom
stringnull
Opcode
object
Represents a struct/opcode log entry in a trace
9 properties 8 required
Contract
object
16 properties
Contracts
array
ContractAction
object
17 properties
AccessList
object
2 properties
ContractResultStateChanges
array
TimestampNullable
stringnull
A Unix timestamp in seconds.nanoseconds format
Links
object
1 property
ContractLog
EvmAddress
string
A network entity encoded as an EVM address in hex.
ContractResultsResponse
object
2 properties
ContractState
object
5 properties 5 required
ContractActions
array
LogTopicQueryParam
array
Key
objectnull
The public key which controls access to various network entities.
2 properties
EvmAddressNullable
stringnull
A network entity encoded as an EVM address in hex.
ContractLogs
array
ContractResultLogs
array
ContractResultDetails
ContractResultLog
object
6 properties
ContractResultStateChange
object
5 properties
Error
object
1 property
TimestampRange
object
A timestamp range an entity is valid for
2 properties
ContractsResponse
object
2 properties
ContractLogsResponse
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hedera-contracts-api-openapi.yml Raw ↑

Other APIs Hedera publishes across the network.

Hedera Accounts API
AE Profile APIs.io
Hedera Airdrops API
AE Profile APIs.io
Hedera Balances API
AE Profile APIs.io
Hedera Blocks API
AE Profile APIs.io
Hedera Network API
AE Profile APIs.io
Hedera Schedules API
AE Profile APIs.io
Hedera Tokens API
AE Profile APIs.io
Hedera Topics API
AE Profile APIs.io
Hedera Transactions API
AE Profile APIs.io
#Contracts
← Back to H APIs
API Details
ID
hedera:hedera-contracts-api
Base URL
https://mainnet.mirrornode.hedera.com
Docs
https://docs.hedera.com/hedera/sdks-and-apis/rest-api
Provider
Hedera
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=hedera-contracts-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/hedera-contracts-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Hedera Contracts API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.