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.

Operations 12

POST /api/v1/contracts/call Invoke a smart contract #
GET /api/v1/contracts List contract entities on network #
GET /api/v1/contracts/{contractIdOrAddress} Get contract by id #
GET /api/v1/contracts/{contractIdOrAddress}/results List contract results from a contract on the network #
GET /api/v1/contracts/{contractIdOrAddress}/state The contract state from a contract on the network #
GET /api/v1/contracts/{contractIdOrAddress}/results/{timestamp} Get the contract result from a contract on the network executed at a given… #
GET /api/v1/contracts/results List contract results from all contracts on the network #
GET /api/v1/contracts/results/{transactionIdOrHash} Get the contract result from a contract on the network for a given… #
GET /api/v1/contracts/results/{transactionIdOrHash}/actions Get the contract actions from a contract on the network for a given… #
GET /api/v1/contracts/results/{transactionIdOrHash}/opcodes Get the opcode traces for a historical transaction on the network with the… #
GET /api/v1/contracts/{contractIdOrAddress}/results/logs List contract logs from a contract on the network #
GET /api/v1/contracts/results/logs List contracts logs across many contracts on the network #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/hedera:hedera-contracts-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

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

OpenAPI Specification

hedera-contracts-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Mirror Node REST Contracts API
  version: 0.156.0
  license:
    name: Apache-2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  description: 'The REST API offers the ability to query transactions and entity information from a mirror node.


    Base url: /api/v1


    OpenAPI Spec: /api/v1/docs/openapi.yml'
  contact:
    name: Mirror Node Team
    email: mirrornode@hedera.com
    url: https://github.com/hiero-ledger/hiero-mirror-node
servers:
- description: The current REST API server
  url: ''
- description: The production REST API servers
  url: '{scheme}://{network}.mirrornode.hedera.com'
  variables:
    scheme:
      default: https
      description: The URI scheme
      enum:
      - http
      - https
    network:
      default: testnet
      description: The Hedera network in use
      enum:
      - mainnet-public
      - mainnet
      - previewnet
      - testnet
tags:


# --- truncated at 32 KB (65 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/hedera/refs/heads/main/openapi/hedera-contracts-api-openapi.yml