Wormhole website screenshot

Wormhole

Wormhole is a decentralized cross-chain messaging and interoperability protocol connecting 45+ blockchain networks. It provides REST APIs for querying VAA (Verifiable Action Approval) status, native and wrapped token transfers, cross-chain operations, and Guardian Network data via the Wormholescan API. Developers can build multichain applications with the TypeScript SDK, CLI tooling, and the Connect bridging widget.

Wormhole publishes 3 APIs on the APIs.io network: Guardian API, wormhole API, and wormholescan API. Tagged areas include Cross-Chain, Blockchain, Interoperability, DeFi, and Token Transfers.

The Wormhole catalog on APIs.io includes 1 Spectral governance ruleset.

Wormhole’s developer surface includes developer portal, GitHub presence, engineering blog, status page, and 11 more developer resources.

34.9/100 thin ▼ -7.8 Agent 22/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemium
7 APIs
Cross-ChainBlockchainInteroperabilityDeFiToken TransfersMessagingWeb3

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 34.9/100 · thin
Contract Quality 8.1 / 25
Developer Ergonomics 3.0 / 20
Commercial Clarity 10.0 / 20
Operational Transparency 1.4 / 13
Governance 7.0 / 12
Discoverability 8.2 / 10
Agent readiness — 22/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 0 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/wormhole: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 7

Individual APIs this provider publishes, each with its own machine-readable definition.

Wormholescan Testnet API

Testnet version of the Wormholescan REST API for development and testing against Wormhole-supported test networks. Mirrors the mainnet API surface for VAAs, operations, and toke...

Wormhole TypeScript SDK

Unified TypeScript SDK for building cross-chain applications on Wormhole. Supports Native Token Transfers, Wrapped Token Transfers, CCTP, Settlement, and core messaging/VAA hand...

Wormhole Connect Widget

Embeddable React widget that provides a full cross-chain token transfer UI powered by Wormhole. Supports 45+ chains and integrates Native Token Transfers, Wrapped Token Transfer...

Wormhole CLI

Command-line interface for interacting with Wormhole protocol operations including token transfers, NTT deployments, and cross-chain messaging tasks.

Wormhole Guardian API

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

Wormhole wormhole API

The wormhole API from Wormhole — 1 operation(s) for wormhole.

Wormhole wormholescan API

The wormholescan API from Wormhole — 64 operation(s) for wormholescan.

Scroll for all 7

Pricing Plans 1

Published pricing tiers and plan structures.

Plans

2 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Rate Limits

0 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Finops

FINOPS

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

Wormhole API Rules

5 rules · 3 warnings 2 info

SPECTRAL

JSON Schema 113

Standalone JSON Schema definitions for this provider's data models.

address.AddressOverview

1 properties

JSON SCHEMA

governor.AvailableNotionalResponse

1 properties

JSON SCHEMA

governor.Emitter

3 properties

JSON SCHEMA

governor.EnqueuedVaa

5 properties

JSON SCHEMA

governor.EnqueuedVaaDetail

6 properties

JSON SCHEMA

governor.EnqueuedVaaItemResponse

6 properties

JSON SCHEMA

governor.EnqueuedVaaResponse

1 properties

JSON SCHEMA

governor.EnqueuedVaas

2 properties

JSON SCHEMA

governor.GovConfig

7 properties

JSON SCHEMA

governor.GovConfigChains

3 properties

JSON SCHEMA

governor.GovConfigfTokens

3 properties

JSON SCHEMA

governor.GovernorLimit

4 properties

JSON SCHEMA

governor.GovernorVaasResponse

8 properties

JSON SCHEMA

governor.GovStatus

5 properties

JSON SCHEMA

governor.GovStatusChainEmitter

3 properties

JSON SCHEMA

governor.GovStatusChains

3 properties

JSON SCHEMA

governor.MaxNotionalAvailableRecord

7 properties

JSON SCHEMA

governor.NotionalAvailable

2 properties

JSON SCHEMA

governor.NotionalAvailableDetail

6 properties

JSON SCHEMA

governor.NotionalLimitDetail

7 properties

JSON SCHEMA

governor.TokenList

3 properties

JSON SCHEMA

guardian.GuardianSetResponse

1 properties

JSON SCHEMA

guardian_sets.GuardianAddress

2 properties

JSON SCHEMA

guardian_sets.GuardianSetDoc

2 properties

JSON SCHEMA

heartbeats.HeartbeatNetworkResponse

4 properties

JSON SCHEMA

heartbeats.HeartbeatResponse

3 properties

JSON SCHEMA

heartbeats.HeartbeatsResponse

1 properties

JSON SCHEMA

heartbeats.RawHeartbeat

8 properties

JSON SCHEMA

infrastructure.VersionResponse

3 properties

JSON SCHEMA

observations.ObservationDoc

10 properties

JSON SCHEMA

operations.Content

3 properties

JSON SCHEMA

operations.Data

2 properties

JSON SCHEMA

operations.EmitterAddress

2 properties

JSON SCHEMA

operations.OperationResponse

9 properties

JSON SCHEMA

operations.SourceChain

11 properties

JSON SCHEMA

operations.StandardizedProperties

12 properties

JSON SCHEMA

operations.TargetChain

10 properties

JSON SCHEMA

operations.Transaction

2 properties

JSON SCHEMA

operations.Vaa

3 properties

JSON SCHEMA

parser.StandardizedProperties

12 properties

JSON SCHEMA

protocols.ProtocolNetworkPairResponse

2 properties

JSON SCHEMA

protocols.ProtocolNetworkPairResult

3 properties

JSON SCHEMA

protocols.ProtocolNetworkPairVolume

3 properties

JSON SCHEMA

protocols.ProtocolTotalValuesDTO

10 properties

JSON SCHEMA

protocols.ProtocolTrendingToken

7 properties

JSON SCHEMA

relays.DeliveryReponse

5 properties

JSON SCHEMA

relays.InstructionsResponse

11 properties

JSON SCHEMA

relays.RelayDataResponse

5 properties

JSON SCHEMA

relays.RelayResponse

7 properties

JSON SCHEMA

relays.ResultExecutionResponse

6 properties

JSON SCHEMA

response.APIError

3 properties

JSON SCHEMA

response.ErrorDetail

2 properties

JSON SCHEMA

response.Response-array_vaa_VaaDoc

2 properties

JSON SCHEMA

response.Response-array_vaa_VaaStats

2 properties

JSON SCHEMA

response.Response-governor_GovConfig

2 properties

JSON SCHEMA

response.Response-governor_GovStatus

2 properties

JSON SCHEMA

response.ResponsePagination

1 properties

JSON SCHEMA

stats.image

3 properties

JSON SCHEMA

stats.NativeTokenTransferActivity

4 properties

JSON SCHEMA

stats.NativeTokenTransferByTime

3 properties

JSON SCHEMA

stats.NativeTokenTransferSummary

11 properties

JSON SCHEMA

stats.NativeTokenTransferTopAddress

2 properties

JSON SCHEMA

stats.NativeTokenTransferTopHolder

3 properties

JSON SCHEMA

stats.Token

21 properties

JSON SCHEMA

stats.TokenInfoDTO

18 properties

JSON SCHEMA

stats.TokenResult

5 properties

JSON SCHEMA

stats.TokenType

0 properties

JSON SCHEMA

stats.TopCorridor

5 properties

JSON SCHEMA

stats.TopCorridorsResult

1 properties

JSON SCHEMA

stats.TopSymbolByVolumeResult

1 properties

JSON SCHEMA

stats.TopSymbolResult

4 properties

JSON SCHEMA

supply.SupplyInfoResponse

2 properties

JSON SCHEMA

transactions.AssetWithVolume

5 properties

JSON SCHEMA

transactions.AttributeDoc

2 properties

JSON SCHEMA

transactions.ChainActivity

1 properties

JSON SCHEMA

transactions.ChainActivityTopResult

6 properties

JSON SCHEMA

transactions.ChainPair

3 properties

JSON SCHEMA

transactions.Destination

3 properties

JSON SCHEMA

transactions.DestinationTx

9 properties

JSON SCHEMA

transactions.GlobalTransactionDoc

3 properties

JSON SCHEMA

transactions.ListTransactionsResponse

1 properties

JSON SCHEMA

transactions.OriginTx

4 properties

JSON SCHEMA

transactions.ScorecardsResponse

14 properties

JSON SCHEMA

transactions.Token

3 properties

JSON SCHEMA

transactions.TopAssetsResponse

1 properties

JSON SCHEMA

transactions.TopChainPairsResponse

1 properties

JSON SCHEMA

transactions.TransactionCountResult

2 properties

JSON SCHEMA

transactions.TransactionDetail

12 properties

JSON SCHEMA

transactions.Tx

4 properties

JSON SCHEMA

vaa.ChainID

0 properties

JSON SCHEMA

vaa.VaaDoc

15 properties

JSON SCHEMA

vaa.VaaStats

2 properties

JSON SCHEMA

workflow.Event

8 properties

JSON SCHEMA

workflow.EventStatus

0 properties

JSON SCHEMA

workflow.EventType

0 properties

JSON SCHEMA

Scroll for all 113

Examples 74

Example request and response payloads for these APIs.

Api V1 Top 100 Corridors

7 fields

EXAMPLE

Application Activity

7 fields

EXAMPLE

Circulating Supply

7 fields

EXAMPLE

Find Address By Id

7 fields

EXAMPLE

Find All Vaas

7 fields

EXAMPLE

Find Duplicated Vaa By Id

7 fields

EXAMPLE

Find Observations By Id

7 fields

EXAMPLE

Find Observations

7 fields

EXAMPLE

Find Relay By Vaa Id

7 fields

EXAMPLE

Find Vaa By Id

7 fields

EXAMPLE

Find Vaas By Chain

7 fields

EXAMPLE

Find Vaas By Emitter

7 fields

EXAMPLE

Get Guardian Set

7 fields

EXAMPLE

Get Last Transactions

7 fields

EXAMPLE

Get Operation By Id

7 fields

EXAMPLE

Get Operations

7 fields

EXAMPLE

Get Scorecards

7 fields

EXAMPLE

Get Secured Tokens

7 fields

EXAMPLE

Get Top Assets By Volume

7 fields

EXAMPLE

Get Top Protocols Stats

7 fields

EXAMPLE

Get Transaction By Id

7 fields

EXAMPLE

Get Vaa Counts

7 fields

EXAMPLE

Get Version

7 fields

EXAMPLE

Governor Config

7 fields

EXAMPLE

Governor Enqueued Vaas

7 fields

EXAMPLE

Governor Notional Limit

7 fields

EXAMPLE

Governor Status

7 fields

EXAMPLE

Governor Vaas

7 fields

EXAMPLE

Guardian Set

7 fields

EXAMPLE

Guardians Enqueued Vaas

7 fields

EXAMPLE

Guardians Find Signed Vaa

7 fields

EXAMPLE

Guardians Hearbeats

7 fields

EXAMPLE

Guardians Is Vaa Enqueued

7 fields

EXAMPLE

Guardians Token List

7 fields

EXAMPLE

Health Check

7 fields

EXAMPLE

List Transactions

7 fields

EXAMPLE

Live Tracking Subscribe

7 fields

EXAMPLE

Parse Vaa

7 fields

EXAMPLE

Ready Check

7 fields

EXAMPLE

Search Operations

7 fields

EXAMPLE

Supply Info

7 fields

EXAMPLE

Swagger

7 fields

EXAMPLE

Top Symbols By Volume

7 fields

EXAMPLE

Total Supply

7 fields

EXAMPLE

X Chain Activity Tops

7 fields

EXAMPLE

X Chain Activity

7 fields

EXAMPLE

Scroll for all 74

Security Posture 1

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Wormhole Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Wormhole Agentic Access

74 operations · 2 acting

74 operations · 2 acting

AGENTIC

Resources

Get Started 1

Portal, sign-up, and the first successful call

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Build 1

SDKs, sample code, and the tooling you integrate with

Access & Security 2

Authentication, authorization, and security posture

Operate 5

Status, limits, changes, and where to get help

Commercial 2

Pricing, plans, and the legal terms of use

Company 2

The organization behind the API

Other 1

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
name: Wormhole
description: 'Wormhole is a decentralized cross-chain messaging and interoperability protocol connecting 45+ blockchain networks.
  It provides REST APIs for querying VAA (Verifiable Action Approval) status, native and wrapped token transfers, cross-chain
  operations, and Guardian Network data via the Wormholescan API. Developers can build multichain applications with the TypeScript
  SDK, CLI tooling, and the Connect bridging widget.

  '
accessModel:
  pricing: freemium
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Freemium
  confidence: medium
  source:
  - plans
  generated: '2026-07-22'
  method: derived
image: https://wormhole.com/logo.png
tags:
- Cross-Chain
- Blockchain
- Interoperability
- DeFi
- Token Transfers
- Messaging
- Web3
url: https://wormhole.com/
baseURL: https://api.wormholescan.io
apis:
- name: Wormholescan Testnet API
  description: 'Testnet version of the Wormholescan REST API for development and testing against Wormhole-supported test networks.
    Mirrors the mainnet API surface for VAAs, operations, and token transfers in a non-production environment.

    '
  humanURL: https://wormhole.com/docs/products/messaging/guides/wormholescan-api/
  baseURL: https://api.testnet.wormholescan.io/api/v1
  tags:
  - Testnet
  - VAA
  - Token Transfers
  - Development
  properties:
  - type: Documentation
    url: https://wormhole.com/docs/products/messaging/guides/wormholescan-api/
  contact:
  - FN: Wormhole Developer Support
    url: https://wormhole.com/contact
  meta:
  - key: environment
    value: testnet
- name: Wormhole TypeScript SDK
  description: 'Unified TypeScript SDK for building cross-chain applications on Wormhole. Supports Native Token Transfers,
    Wrapped Token Transfers, CCTP, Settlement, and core messaging/VAA handling across EVM chains, Solana, Algorand, Aptos,
    CosmWasm, and Sui.

    '
  humanURL: https://wormhole.com/docs/tools/typescript-sdk/get-started/
  baseURL: https://npmjs.com/package/@wormhole-foundation/sdk
  tags:
  - SDK
  - TypeScript
  - Cross-Chain
  - Token Transfers
  properties:
  - type: Documentation
    url: https://wormhole.com/docs/tools/typescript-sdk/get-started/
  - type: github
    url: https://github.com/wormhole-foundation/wormhole-sdk-ts
  - type: npm
    url: https://www.npmjs.com/package/@wormhole-foundation/sdk
  contact:
  - FN: Wormhole Foundation
    url: https://github.com/wormhole-foundation
  meta:
  - key: npm-package
    value: '@wormhole-foundation/sdk'
- name: Wormhole Connect Widget
  description: 'Embeddable React widget that provides a full cross-chain token transfer UI powered by Wormhole. Supports 45+
    chains and integrates Native Token Transfers, Wrapped Token Transfers, CCTP, and Settlement routing.

    '
  humanURL: https://wormhole.com/docs/products/connect/get-started/
  baseURL: https://npmjs.com/package/@wormhole-foundation/wormhole-connect
  tags:
  - Widget
  - React
  - UI
  - Token Bridge
  properties:
  - type: Documentation
    url: https://wormhole.com/docs/products/connect/get-started/
  - type: npm
    url: https://www.npmjs.com/package/@wormhole-foundation/wormhole-connect
  contact:
  - FN: Wormhole Foundation
    url: https://github.com/wormhole-foundation
  meta:
  - key: npm-package
    value: '@wormhole-foundation/wormhole-connect'
- name: Wormhole CLI
  description: 'Command-line interface for interacting with Wormhole protocol operations including token transfers, NTT deployments,
    and cross-chain messaging tasks.

    '
  humanURL: https://wormhole.com/docs/tools/cli/get-started/
  baseURL: https://npmjs.com/package/@wormhole-foundation/cli
  tags:
  - CLI
  - Developer Tools
  - Token Transfers
  - NTT
  properties:
  - type: Documentation
    url: https://wormhole.com/docs/tools/cli/get-started/
  contact:
  - FN: Wormhole Foundation
    url: https://github.com/wormhole-foundation
  meta:
  - key: tool-type
    value: cli
- aid: wormhole:wormhole-guardian-api
  name: Wormhole Guardian API
  description: The Guardian API from Wormhole — 8 operation(s) for guardian.
  humanURL: https://wormhole.com/docs/products/messaging/guides/wormholescan-api/
  baseURL: https://api.wormholescan.io/api/v1
  tags:
  - Guardian
  properties:
  - type: OpenAPI
    url: openapi/wormhole-guardian-api-openapi.yml
  - type: Documentation
    url: https://wormhole.com/docs/products/messaging/guides/wormholescan-api/
  - type: swagger-ui
    url: https://wormholescan.io/#/developers/api-doc
- aid: wormhole:wormhole-wormhole-api
  name: Wormhole wormhole API
  description: The wormhole API from Wormhole — 1 operation(s) for wormhole.
  humanURL: https://wormhole.com/docs/products/messaging/guides/wormholescan-api/
  baseURL: https://api.wormholescan.io/api/v1
  tags:
  - wormhole
  properties:
  - type: OpenAPI
    url: openapi/wormhole-wormhole-api-openapi.yml
  - type: Documentation
    url: https://wormhole.com/docs/products/messaging/guides/wormholescan-api/
  - type: swagger-ui
    url: https://wormholescan.io/#/developers/api-doc
- aid: wormhole:wormhole-wormholescan-api
  name: Wormhole wormholescan API
  description: The wormholescan API from Wormhole — 64 operation(s) for wormholescan.
  humanURL: https://wormhole.com/docs/products/messaging/guides/wormholescan-api/
  baseURL: https://api.wormholescan.io/api/v1
  tags:
  - wormholescan
  properties:
  - type: OpenAPI
    url: openapi/wormhole-wormholescan-api-openapi.yml
  - type: Documentation
    url: https://wormhole.com/docs/products/messaging/guides/wormholescan-api/
  - type: swagger-ui
    url: https://wormholescan.io/#/developers/api-doc
common:
- type: AgenticAccess
  url: agentic-access/wormhole-agentic-access.yml
- type: DomainSecurity
  url: security/wormhole-domain-security.yml
- type: Portal
  url: https://wormhole.com/docs/
- type: github
  url: https://github.com/wormhole-foundation
- type: explorer
  url: https://wormholescan.io/
- type: Blog
  url: https://wormhole.com/blog/
- type: Contact
  url: https://wormhole.com/contact
- type: Community
  url: https://wormhole.com/community/hub
- type: Forums
  url: https://forum.wormhole.com/
- type: Security
  url: https://immunefi.com/bug-bounty/wormhole/
- type: status
  url: https://wormholescan.io/
- type: Twitter
  url: https://twitter.com/wormhole
- type: Discord
  url: https://discord.gg/wormholecrypto
- type: TermsOfService
  url: https://wormhole.com/terms
- type: PrivacyPolicy
  url: https://wormhole.com/privacy
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
modified: '2026-06-13'
specificationVersion: '0.19'