---
title: "Invoke a smart contract"
method: POST
path: "/api/v1/contracts/call"
tags: ["contracts"]
---

# Invoke a smart contract

`POST /api/v1/contracts/call`

Returns a result from EVM execution such as cost-free execution of read-only smart contract queries, gas estimation, and transient simulation of read-write operations. If the `estimate` field is set to true gas estimation is executed. This API can process calls against the `latest` block or specific historical blocks when a hexadecimal or decimal block number is provided in the `block` field.

## Request body

- ContractCallRequest
  - `block` string, nullable — Hexadecimal block number or the string "latest", "pending", "earliest". Defaults to "latest".
  - `data` string, binary, nullable — Hexadecimal method signature and encoded parameters. Up to 131072 bytes as at most 262146 hexadecimal digits including optional leading 0x.
  - `estimate` boolean, nullable — Whether gas estimation is called. Defaults to false.
  - `from` string, binary, nullable — The 20-byte hexadecimal EVM address the transaction is sent from.
  - `gas` integer, nullable — Gas provided for the transaction execution. Defaults to 15000000.
  - `gasPrice` integer, nullable — Gas price used for each paid gas.
  - `to` string, binary, required — The 20-byte hexadecimal EVM address the transaction is directed to.
  - `value` integer, nullable — Value sent with this transaction. Defaults to 0.

## Response `200`

OK

- ContractCallResponse
  - `result` string, binary — Result in hexadecimal from executed contract call.

## Other responses

- `400` — Validation error
- `404` — Not found error
- `415` — Unsupported media type error
- `429` — Too many requests
- `500` — Generic error
- `501` — Not implemented error

---

[API](https://skmtc.dev/hedera/apis/mirror-node-rest-api.md) · [All operations](https://skmtc.dev/hedera/apis/mirror-node-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hedera/mirror-node-rest-api/revisions/45f5ccac560c/schema)