Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Wormhole Guardian API

The Guardian API from Wormhole — 8 operation(s) for guardian.

Wormhole Guardian API is one of 7 APIs that Wormhole publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Guardian. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 8 operations across 8 paths, and defines 12 schemas. It is described by OpenAPI 2.0, at version 1.0.

Requests are made against the base URL https://api.wormholescan.io/api/v1.

8 operations 8 paths 12 schemas 8 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
1.0
Base URL
https://api.wormholescan.io/api/v1
License
Terms of Service
Resource Areas
1

Paths & Operations 8

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

Guardian 8
GET
/v1/governor/available_notional_by_chain
Get available notional by chainID Since from the wormhole-explorer point of view it is not a node, but has the information of all nodes, in order to build the endpoints it was assumed: There are N nu…
governor-available-notional-by-chain → 200400500
GET
/v1/governor/enqueued_vaas
Get enqueued VAAs
guardians-enqueued-vaas → 200400500
GET
/v1/governor/is_vaa_enqueued/:chain_id/:emitter/:seq
Check if vaa is enqueued
guardians-is-vaa-enqueued 3 params → 200400500
GET
/v1/governor/token_list
Get token list Since from the wormhole-explorer point of view it is not a node, but has the information of all nodes, in order to build the endpoints it was assumed: For tokens with the same originCh…
guardians-token-list → 200400500
GET
/v1/guardianset/current
Get current guardian set.
guardian-set → 200400500
GET
/v1/heartbeats
Get heartbeats for guardians
guardians-hearbeats → 200400500
GET
/v1/signed_batch_vaa/:chain_id/:emitter/sequence/:seq
get a batch of VAA []byte from a chainID, emitter address and sequence.
guardians-find-signed-batch-vaa 3 params → 200400500
GET
/v1/signed_vaa/:chain_id/:emitter/:seq
get a VAA []byte from a chainID, emitter address and sequence.
guardians-find-signed-vaa 3 params → 200400500

Schemas 12

The contract defines 12 schemas that model the data the API accepts and returns. The most detailed are heartbeats.RawHeartbeat (8 properties), governor.EnqueuedVaaItemResponse (6 properties), heartbeats.HeartbeatNetworkResponse (4 properties), governor.AvailableNotionalItemResponse (4 properties). Each schema is shown below with its type and property counts.

governor.AvailableNotionalResponse
object
1 property
github_com_wormhole-foundation_wormhole-explorer_api_routes_guardian_guardian.GuardianSet
object
2 properties
governor.AvailableNotionalItemResponse
object
4 properties
heartbeats.HeartbeatsResponse
object
1 property
governor.EnqueuedVaaItemResponse
object
6 properties
heartbeats.HeartbeatNetworkResponse
object
4 properties
governor.TokenList
object
3 properties
governor.EnqueuedVaaResponse
object
1 property
heartbeats.HeartbeatResponse
object
3 properties
guardian.GuardianSetResponse
object
1 property
vaa.ChainID
integer
heartbeats.RawHeartbeat
object
8 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wormhole-guardian-api-openapi.yml Raw ↑

Other APIs Wormhole publishes across the network.

Wormholescan Testnet API
Wormhole TypeScript SDK
Wormhole Connect Widget
Wormhole CLI
Wormhole wormhole API
Wormhole wormholescan API