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
Ava Protocol

Ava Protocol Nodes API

Stand-alone node execution

Documentation Provider Profile APIs.io OpenAPI GitHub

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

Tagged areas include Nodes. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 1 operation across 1 path, and defines 39 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against 3 base URLs: https://gateway.avaprotocol.org/api/v1, https://gateway-staging.avaprotocol.org/api/v1, http://localhost:8080/api/v1.

1 operations 1 paths 39 schemas 1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://gateway.avaprotocol.org/api/v1
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Ava Protocol Nodes API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — JWT bearer token. Obtained via POST /auth:exchange (wallet signature flow) or via the operator-run create-api-key CLI (long-lived, server-to-server). Send on e…

Paths & Operations 1

Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.

Nodes 1

Stand-alone node execution

POST
/nodes:run
Execute a single node with inline input variables
runNode body → 200400401

Schemas 39

The contract defines 39 schemas that model the data the API accepts and returns. The most detailed are ContractWriteNodeConfig (8 properties), ERC20StateOverride (7 properties), BalanceNodeConfig (6 properties), EventTriggerQuery (6 properties). Each schema is shown below with its type and property counts.

ContractReadNode
CustomCodeNodeConfig
object
2 properties 2 required
EthereumAddress
string
Lowercase or checksummed hex EOA / contract address.
ETHTransferNode
LoopNodeConfig
object
Iterates over an input array, running an inner Node per item. The runner node is one of the chain-aware or chain-agnostic node types; a chain-aware runner must…
3 properties 2 required
ContractWriteNode
AwaitNode
EventCondition
object
Predicate evaluated against decoded event data.
4 properties 3 required
GraphQLQueryNodeConfig
object
3 properties 2 required
ContractWriteNodeConfig
object
8 properties 2 required
GraphQLQueryNode
Lang
string
Language/format of an inline payload (e.g., custom code source, manual trigger data). Mirrors the proto Lang enum minus the LANG prefix. Wire values are lowerc…
BranchCondition
object
3 properties 2 required
BalanceNode
EventTriggerConfig
object
Fires when matching on-chain events are observed.
3 properties 2 required
CustomCodeNode
FilterNode
ChainId
integer
Numeric chain ID (e.g. 11155111 for Sepolia, 8453 for Base). On chain-aware trigger/node configs this is required and must be a configured chain; on query/filt…
RestAPINode
EventTriggerQuery
object
Single ethereum.FilterQuery — one subscription per query.
6 properties
Node
object
3 properties 3 required
Problem
object
RFC 7807 problem+json. Returned as application/problem+json on any 4xx/5xx response. type and title describe the error class; detail is human-readable; instanc…
6 properties 3 required
LoopNode
Hex
string
Arbitrary-length hex-encoded byte string.
ETHTransferNodeConfig
object
3 properties 3 required
ContractReadNodeConfig
object
4 properties 2 required
EventMethodCall
object
4 properties 1 required
BranchNode
InputVariables
object
Free-form key-value bag of values used to resolve {{variable.path}} template references inside trigger and node configs. Conventional well-known keys: settings…
ERC20StateOverride
object
Seeds a token's balanceOf / allowance storage slots for a single simulation. balanceOf[owner] lives at keccak256(abi.encode(owner, balanceSlot)); allowance[own…
7 properties 2 required
RunNodeRequest
object
4 properties 1 required
BalanceNodeConfig
object
6 properties 2 required
RestAPINodeConfig
object
5 properties 2 required
MethodCall
object
One call to a contract method (used by ContractWrite + ContractRead).
4 properties 1 required
RunNodeResponse
object
6 properties 1 required
AwaitNodeConfig
object
Pauses the workflow until a wake arrives (durable execution). Two mutually exclusive flavors: the external-signal flavor (human approval — set channel, e.g. a…
5 properties
FilterNodeConfig
object
2 properties 2 required
BranchNodeConfig
object
1 property 1 required
NodeType
string
Discriminator field for the Node union. Mirrors the proto NodeType enum but without the NODETYPE prefix.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ava-protocol-nodes-api-openapi.yml Raw ↑

Other APIs Ava Protocol publishes across the network.

Ava Protocol Auth API
AE Profile APIs.io
Ava Protocol Executions API
AE Profile APIs.io
Ava Protocol Health API
AE Profile APIs.io
Ava Protocol Operators API
AE Profile APIs.io
Ava Protocol Secrets API
AE Profile APIs.io
Ava Protocol Tokens API
AE Profile APIs.io
Ava Protocol Triggers API
AE Profile APIs.io
Ava Protocol Wallets API
AE Profile APIs.io
Ava Protocol Workflows API
AE Profile APIs.io
#Nodes
← Back to A APIs
API Details
ID
ava-protocol:ava-protocol-nodes-api
Base URL
https://gateway.avaprotocol.org/api/v1
Docs
https://avaprotocol.org/docs/ava-sdk-js/rest-api
Provider
Ava Protocol
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=ava-protocol-nodes-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/ava-protocol-nodes-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 Ava Protocol Nodes 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.