WormholeScan

https://wormholescan.io/developers/wormholescan-doc
Admin
WormholeScan is a public REST API for querying Wormhole Guardian network status and cross-chain...
Tokens:3,502
Snippets:22
Trust Score:8.3
Update:5 months ago
Show doc for...
Tokens:
Raw
### Status & Version

Source: https://wormholescan.io/#/developers/wormholescan-doc/api-doc

Check the current API health, version information, and readiness status.

```APIDOC
## GET /api/v1/health

### Description
Check the health status of the API.

### Method
GET

### Endpoint
/api/v1/health

## GET /api/v1/version

### Description
Get the current version of the API.

### Method
GET

### Endpoint
/api/v1/version

## GET /api/v1/ready

### Description
Check if the API is ready to serve requests.

### Method
GET

### Endpoint
/api/v1/ready
```

--------------------------------

### Live Tracking

Source: https://wormholescan.io/#/developers/wormholescan-doc/api-doc

Subscribe to real-time updates on a transaction's status using its VAA ID or transaction hash.

```APIDOC
## GET /api/v1/live-tracking/subscribe

### Description
Real-time subscription to a transaction's status via VAA ID or transaction hash.

### Method
GET

### Endpoint
/api/v1/live-tracking/subscribe
```

--------------------------------

### Protocols

Source: https://wormholescan.io/#/developers/wormholescan-doc/api-doc

View activity and metrics for protocols integrated with Wormhole and indexed by WormholeScan.

```APIDOC
## GET /api/v1/application-activity

### Description
Get activity data for applications integrated with Wormhole.

### Method
GET

### Endpoint
/api/v1/application-activity

## GET /api/v1/protocols/stats

### Description
Get statistics for protocols integrated with Wormhole.

### Method
GET

### Endpoint
/api/v1/protocols/stats

## GET /api/v1/protocols/{protocolId}/top_network_pairs

### Description
Get top network pairs for a specific protocol.

### Method
GET

### Endpoint
/api/v1/protocols/{protocolId}/top_network_pairs

## GET /api/v1/protocols/{protocolId}/trending_tokens

### Description
Get trending tokens for a specific protocol.

### Method
GET

### Endpoint
/api/v1/protocols/{protocolId}/trending_tokens
```

--------------------------------

### Native Token Transfers (NTT)

Source: https://wormholescan.io/#/developers/wormholescan-doc/api-doc

View transfer activity, volumes, and deployment details for NTT tokens, including per-chain limits.

```APIDOC
## GET /api/v1/native-token-transfer/activity

### Description
Get activity data for Native Token Transfers (NTT).

### Method
GET

### Endpoint
/api/v1/native-token-transfer/activity

## GET /api/v1/native-token-transfer/summary

### Description
Get a summary of Native Token Transfer (NTT) activity.

### Method
GET

### Endpoint
/api/v1/native-token-transfer/summary

## GET /api/v1/native-token-transfer/token-list

### Description
Get a list of Native Token Transfer (NTT) tokens.

### Method
GET

### Endpoint
/api/v1/native-token-transfer/token-list

## GET /api/v1/native-token-transfer/top-address

### Description
Get the top addresses by Native Token Transfer (NTT) activity.

### Method
GET

### Endpoint
/api/v1/native-token-transfer/top-address

## GET /api/v1/native-token-transfer/top-holder

### Description
Get the top holders of Native Token Transfer (NTT) tokens.

### Method
GET

### Endpoint
/api/v1/native-token-transfer/top-holder

## GET /api/v1/native-token-transfer/transfer-by-time

### Description
Get Native Token Transfer (NTT) data filtered by time.

### Method
GET

### Endpoint
/api/v1/native-token-transfer/transfer-by-time

## GET /api/v1/ntt/token/ownedBy/{address}

### Description
Get NTT tokens owned by a specific address.

### Method
GET

### Endpoint
/api/v1/ntt/token/ownedBy/{address}

## GET /api/v1/ntt/token/{chainId}/{address}

### Description
Get NTT token details for a specific chain and address.

### Method
GET

### Endpoint
/api/v1/ntt/token/{chainId}/{address}

## GET /api/v1/ntt/limits/{chainId}/{managerAddress}

### Description
Get NTT limits for a specific chain and manager address.

### Method
GET

### Endpoint
/api/v1/ntt/limits/{chainId}/{managerAddress}
```

--------------------------------

### VAAs

Source: https://wormholescan.io/#/developers/wormholescan-doc/api-doc

Locate, list, and decode Verifiable Action Approvals (VAAs) by ID, chain, emitter, or transaction hash.

```APIDOC
## GET /api/v1/vaas/

### Description
Locate and list Verifiable Action Approvals (VAAs).

### Method
GET

### Endpoint
/api/v1/vaas/

## GET /api/v1/vaas/{chain_id}

### Description
Locate and list VAAs for a specific chain.

### Method
GET

### Endpoint
/api/v1/vaas/{chain_id}

## GET /api/v1/vaas/{chain_id}/{emitter}

### Description
Locate and list VAAs for a specific chain and emitter.

### Method
GET

### Endpoint
/api/v1/vaas/{chain_id}/{emitter}

## GET /api/v1/vaas/{chain_id}/{emitter}/{seq}

### Description
Locate and list a specific VAA identified by chain ID, emitter, and sequence number.

### Method
GET

### Endpoint
/api/v1/vaas/{chain_id}/{emitter}/{seq}

## GET /api/v1/vaas/{chain_id}/{emitter}/{seq}/duplicated

### Description
Check for duplicated VAAs for a specific VAA identified by chain ID, emitter, and sequence number.

### Method
GET

### Endpoint
/api/v1/vaas/{chain_id}/{emitter}/{seq}/duplicated

## POST /api/v1/vaas/parse

### Description
Decode Verifiable Action Approvals (VAAs).

### Method
POST

### Endpoint
/api/v1/vaas/parse
```

--------------------------------

### Guardian API (Legacy)

Source: https://wormholescan.io/#/developers/wormholescan-doc/api-doc

Legacy namespace for direct Guardian-node calls; use only when no modern equivalent exists.

```APIDOC
## GET /v1/governor/enqueued_vaas

### Description
Query enqueued VAAs in the governor (legacy endpoint).

### Method
GET

### Endpoint
/v1/governor/enqueued_vaas

## GET /v1/governor/is_vaa_enqueued/{chain_id}/{emitter}/{seq}

### Description
Check if a VAA is enqueued in the governor (legacy endpoint).

### Method
GET

### Endpoint
/v1/governor/is_vaa_enqueued/{chain_id}/{emitter}/{seq}
```

--------------------------------

### Analytics & Metrics

Source: https://wormholescan.io/#/developers/wormholescan-doc/api-doc

Aggregated KPIs across tokens, chains, and protocols, including volume, counts, and historical trends.

```APIDOC
## GET /api/v1/x-chain-activity

### Description
Get cross-chain activity metrics.

### Method
GET

### Endpoint
/api/v1/x-chain-activity

## GET /api/v1/x-chain-activity/tops

### Description
Get top cross-chain activity metrics.

### Method
GET

### Endpoint
/api/v1/x-chain-activity/tops

## GET /api/v1/top-assets-by-volume

### Description
Get top assets by volume.

### Method
GET

### Endpoint
/api/v1/top-assets-by-volume

## GET /api/v1/top-chain-pairs-by-num-transfers

### Description
Get top chain pairs by number of transfers.

### Method
GET

### Endpoint
/api/v1/top-chain-pairs-by-num-transfers

## GET /api/v1/top-symbols-by-volume

### Description
Get top symbols by volume.

### Method
GET

### Endpoint
/api/v1/top-symbols-by-volume

## GET /api/v1/top-100-corridors

### Description
Get top 100 corridors.

### Method
GET

### Endpoint
/api/v1/top-100-corridors

## GET /api/v1/scorecards

### Description
Get scorecards.

### Method
GET

### Endpoint
/api/v1/scorecards

## GET /api/v1/wormhole/assets/secured-tokens

### Description
Get secured tokens in the Wormhole ecosystem.

### Method
GET

### Endpoint
/api/v1/wormhole/assets/secured-tokens
```

--------------------------------

### Tokens

Source: https://wormholescan.io/#/developers/wormholescan-doc/api-doc

Access rankings and statistics for tokens, including top all-time or within a date range, and per-token activity.

```APIDOC
## GET /api/v1/tokens-symbol-activity

### Description
Get activity data for tokens.

### Method
GET

### Endpoint
/api/v1/tokens-symbol-activity

## GET /api/v1/tokens-symbol-volume

### Description
Get volume data for tokens.

### Method
GET

### Endpoint
/api/v1/tokens-symbol-volume
```

--------------------------------

### Operations

Source: https://wormholescan.io/#/developers/wormholescan-doc/api-doc

Retrieve detailed source and destination data for any Wormhole operation. You can search by transaction hash, address, or VAA ID.

```APIDOC
## GET /api/v1/operations

### Description
Detailed source and destination data for any Wormhole operation. Search by transaction hash, address, or VAA ID.

### Method
GET

### Endpoint
/api/v1/operations

## GET /api/v1/operations/{chain_id}/{emitter}/{seq}

### Description
Detailed source and destination data for a specific Wormhole operation identified by chain ID, emitter address, and sequence number.

### Method
GET

### Endpoint
/api/v1/operations/{chain_id}/{emitter}/{seq}
```

--------------------------------

### Observations

Source: https://wormholescan.io/#/developers/wormholescan-doc/api-doc

Fetch guardian observations or trigger custom observation-based operations.

```APIDOC
## GET /api/v1/observations

### Description
Fetch guardian observations.

### Method
GET

### Endpoint
/api/v1/observations

## GET /api/v1/observations/{chain}

### Description
Fetch guardian observations for a specific chain.

### Method
GET

### Endpoint
/api/v1/observations/{chain}

## GET /api/v1/observations/{chain}/{emitter}

### Description
Fetch guardian observations for a specific chain and emitter.

### Method
GET

### Endpoint
/api/v1/observations/{chain}/{emitter}

## GET /api/v1/observations/{chain}/{emitter}/{sequence}

### Description
Fetch guardian observations for a specific chain, emitter, and sequence number.

### Method
GET

### Endpoint
/api/v1/observations/{chain}/{emitter}/{sequence}

## GET /api/v1/observations/{chain}/{emitter}/{sequence}/{signer}/{hash}

### Description
Fetch guardian observations with specific details including signer and hash.

### Method
GET

### Endpoint
/api/v1/observations/{chain}/{emitter}/{sequence}/{signer}/{hash}
```

--------------------------------

### Governor

Source: https://wormholescan.io/#/developers/wormholescan-doc/api-doc

Query governor limits, configuration, status, and transactions throttled by the security mechanism.

```APIDOC
## GET /api/v1/governor/config

### Description
Query governor configuration.

### Method
GET

### Endpoint
/api/v1/governor/config

## GET /api/v1/governor/config/{guardian_address}

### Description
Query governor configuration for a specific guardian address.

### Method
GET

### Endpoint
/api/v1/governor/config/{guardian_address}

## GET /api/v1/governor/enqueued_vaas/

### Description
Query enqueued VAAs in the governor.

### Method
GET

### Endpoint
/api/v1/governor/enqueued_vaas/

## GET /api/v1/governor/enqueued_vaas/{chain}

### Description
Query enqueued VAAs in the governor for a specific chain.

### Method
GET

### Endpoint
/api/v1/governor/enqueued_vaas/{chain}

## GET /api/v1/governor/limit

### Description
Query governor limits.

### Method
GET

### Endpoint
/api/v1/governor/limit

## GET /api/v1/governor/notional/available

### Description
Query available notional capacity in the governor.

### Method
GET

### Endpoint
/api/v1/governor/notional/available

## GET /api/v1/governor/notional/available/{chain}

### Description
Query available notional capacity in the governor for a specific chain.

### Method
GET

### Endpoint
/api/v1/governor/notional/available/{chain}

## GET /api/v1/governor/notional/limit

### Description
Query notional limits in the governor.

### Method
GET

### Endpoint
/api/v1/governor/notional/limit

## GET /api/v1/governor/notional/limit/{chain}

### Description
Query notional limits in the governor for a specific chain.

### Method
GET

### Endpoint
/api/v1/governor/notional/limit/{chain}

## GET /api/v1/governor/notional/max_available/{chain}

### Description
Query maximum available notional capacity in the governor for a specific chain.

### Method
GET

### Endpoint
/api/v1/governor/notional/max_available/{chain}

## GET /api/v1/governor/status

### Description
Query governor status.

### Method
GET

### Endpoint
/api/v1/governor/status

## GET /api/v1/governor/status/{guardian_address}

### Description
Query governor status for a specific guardian address.

### Method
GET

### Endpoint
/api/v1/governor/status/{guardian_address}

## GET /api/v1/governor/vaas

### Description
Query VAAs managed by the governor.

### Method
GET

### Endpoint
/api/v1/governor/vaas
```

--------------------------------

### Others

Source: https://wormholescan.io/#/developers/wormholescan-doc/api-doc

Endpoints that do not fit into the main categories.

```APIDOC
## GET /api/v1/relays/{chain}/{emitter}/{sequence}

### Description
Get relay information for a specific Wormhole operation.

### Method
GET

### Endpoint
/api/v1/relays/{chain}/{emitter}/{sequence}

## GET /api/v1/last-txs

### Description
Get the last recorded transactions.

### Method
GET

### Endpoint
/api/v1/last-txs
```
Tokens:
Raw