Wormhole wormholescan API
The wormholescan API from Wormhole — 64 operation(s) for wormholescan.
Wormhole wormholescan API is one of 7 APIs that Wormhole publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include wormholescan. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.
This API exposes 65 operations across 64 paths, and defines 101 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.
65 operations
64 paths
101 schemas
63 GET2 POST
Metadata
The identity and technical contract details declared by the specification.
Paths & Operations 65
Across 64 paths, the API surfaces 65 operations — 63 GET, 2 POST. Each is listed below with its method, path, parameters, and response codes.
wormholescan 65
GET
/api/v1/address/:address
Lookup an address
GET
/api/v1/application-activity
Search for a specific period of time the number of transactions and the volume per application.
GET
/api/v1/global-tx/:chain_id/:emitter/:seq
Find a global transaction by VAA ID Global transactions is a logical association of two transactions that are related to each other by a unique VAA ID. The first transaction is created on the origin…
GET
/api/v1/governor/config
Returns governor configuration for all guardians.
GET
/api/v1/governor/config/:guardian_address
Returns governor configuration for a given guardian.
GET
/api/v1/governor/enqueued_vaas/
Returns enqueued VAAs for each blockchain.
GET
/api/v1/governor/enqueued_vaas/:chain
Returns all enqueued VAAs for a given blockchain.
GET
/api/v1/governor/limit
Returns the governor limit for all blockchains.
GET
/api/v1/governor/notional/available
Returns the amount of notional value available for each blockchain.
GET
/api/v1/governor/notional/available/:chain
Returns the amount of notional value available for a given blockchain.
GET
/api/v1/governor/notional/limit
Returns the detailed notional limit for all blockchains.
GET
/api/v1/governor/notional/limit/:chain
Returns the detailed notional limit available for a given blockchain.
GET
/api/v1/governor/notional/max_available/:chain
Returns the maximum amount of notional value available for a given blockchain.
GET
/api/v1/governor/status
Returns the governor status for all guardians.
GET
/api/v1/governor/status/:guardian_address
Returns the governor status for a given guardian.
GET
/api/v1/governor/vaas
Returns all vaas in Governor.
GET
/api/v1/guardian_sets/{version}
Returns a guardian set by version, or the current one when "current" is supplied.
GET
/api/v1/health
Health check
GET
/api/v1/last-txs
Returns the number of transactions by a defined time span and sample rate.
GET
/api/v1/live-tracking/subscribe
Subscribe to live tracking events for a VAA or transaction
GET
/api/v1/native-token-transfer/activity
Returns a list of values (tx count or notional) of the Native Token Transfer for a emitter and destination chains.
GET
/api/v1/native-token-transfer/summary
Returns a summary of the Native Token Transfer.
GET
/api/v1/native-token-transfer/token-list
Returns the list of supported Native Token Transfer tokens.
GET
/api/v1/native-token-transfer/top-address
Returns a list of values (tx count or notional) of the Native Token Transfer for address.
GET
/api/v1/native-token-transfer/top-holder
Returns a list of volume and chain of the Native Token Transfer for top holders.
GET
/api/v1/native-token-transfer/transfer-by-time
Returns a list of values (tx count or notional) of the Native Token Transfer for a emitter and destination chains.
GET
/api/v1/observations
Returns all observations, sorted in descending timestamp order.
GET
/api/v1/observations/:chain
Returns all observations for a given blockchain, sorted in descending timestamp order.
GET
/api/v1/observations/:chain/:emitter
Returns all observations for a specific emitter address, sorted in descending timestamp order.
GET
/api/v1/observations/:chain/:emitter/:sequence
Find observations identified by emitter chain, emitter address and sequence.
GET
/api/v1/observations/:chain/:emitter/:sequence/:signer/:hash
Find a specific observation.
GET
/api/v1/observations/delegate/:chain_id
Returns delegate observations for a given chain, sorted in descending timestamp order.
GET
/api/v1/observations/delegate/:chain_id/:emitter_address
Returns delegate observations for a given chain and emitter, sorted in descending timestamp order.
GET
/api/v1/observations/delegate/:chain_id/:emitter_address/:sequence
Returns delegate observations for a given chain, emitter and sequence.
GET
/api/v1/observations/delegate/:chain_id/:emitter_address/:sequence/:guardian_address
Returns delegate observations for a given chain, emitter, sequence and delegate guardian address.
GET
/api/v1/operations
Find all operations.
POST
/api/v1/operations
Find operations by filters. Currently only txHash is supported.
GET
/api/v1/operations/{chain_id}/{emitter}/{seq}
Find operations by ID (chainID/emitter/sequence).
GET
/api/v1/protocols/stats
Returns the representative stats for the top protocols
GET
/api/v1/protocols/{protocolId}/top_network_pairs
Returns the most used network pairs (chains) for a given protocol ranked by USD volume transferred The endpoint automatically selects hourly or daily aggregation based on the time range For ranges <…
GET
/api/v1/protocols/{protocolId}/trending_tokens
Returns the top 100 trending tokens for a given protocol ranked by USD volume transferred The endpoint automatically selects hourly or daily aggregation based on the time range For ranges < 24 hours,…
GET
/api/v1/ready
Ready check
GET
/api/v1/relays/:chain/:emitter/:sequence
Get a specific relay information by chainID, emitter address and sequence.
GET
/api/v1/scorecards
Returns a list of KPIs for Wormhole. TVL is total value locked by token bridge contracts in USD. Volume is the all-time total volume transferred through the token bridge in USD. 24h volume is the vol…
GET
/api/v1/supply
Get W token supply data (circulation and total supply).
GET
/api/v1/supply/circulating
Get W token circulation supply.
GET
/api/v1/supply/total
Get W token total supply.
GET
/api/v1/token/:chain_id/:token_address
Returns a token symbol, coingecko id and address by chain and token address.
GET
/api/v1/top-100-corridors
Returns a list of the top 100 tokens, sorted in descending order by the number of transactions.
GET
/api/v1/top-assets-by-volume
Returns a list of emitterchain and asset pairs with ordered by volume. The volume is calculated using the notional price of the symbol at the day the VAA was emitted.
GET
/api/v1/top-chain-pairs-by-num-transfers
Returns a list of the emitterchain and destinationchain pair ordered by transfer count.
GET
/api/v1/top-symbols-by-volume
Returns a list of symbols by origin chain and tokens. The volume is calculated using the notional price of the symbol at the day the VAA was emitted.
GET
/api/v1/transactions/
Returns transactions. Output is paginated.
GET
/api/v1/transactions/:chain_id/:emitter/:seq
Find VAA metadata by ID.
GET
/api/v1/vaas/
Returns all VAAs. Output is paginated and can also be be sorted.
GET
/api/v1/vaas/:chain_id
Returns all the VAAs generated in specific blockchain.
GET
/api/v1/vaas/:chain_id/:emitter
Returns all all the VAAs generated by a specific emitter address.
GET
/api/v1/vaas/:chain_id/:emitter/:seq
Find a VAA by ID.
GET
/api/v1/vaas/:chain_id/:emitter/:seq/duplicated
Find duplicated VAA by ID.
POST
/api/v1/vaas/parse
Parse a VAA.
GET
/api/v1/vaas/vaa-counts
Returns the total number of VAAs emitted for each blockchain.
GET
/api/v1/version
Get version/release information.
GET
/api/v1/x-chain-activity
Returns a list of chain pairs by origin chain and destination chain. The list could be rendered by notional or transaction count. The volume is calculated using the notional price of the symbol at th…
GET
/api/v1/x-chain-activity/tops
Search for a specific period of time the number of transactions and the volume.
GET
/swagger.json
Returns the swagger specification for this API.
Schemas 101
The contract defines 101 schemas that model the data the API accepts and returns. The most detailed are stats.Token (21 properties), delegate_observations.DelegateObservationDoc (18 properties), vaa.VaaDoc (15 properties), transactions.ScorecardsResponse (14 properties). Each schema is shown below with its type and property counts.
operations.Transaction
object
2 properties
protocols.ProtocolTotalValuesDTO
object
10 properties
response.Response-governor_MaxNotionalAvailableRecord
object
2 properties
transactions.DestinationTx
object
9 properties
response.Response-array_governor_GovStatus
object
2 properties
workflow.EventStatus
string
response.Response-governor_GovConfig
object
2 properties
response.Response-array_vaa_VaaStats
object
2 properties
guardian_sets.GuardianSetDoc
object
2 properties
address.AddressOverview
object
1 property
governor.GovStatus
object
5 properties
infrastructure.VersionResponse
object
3 properties
response.Response-governor_GovStatus
object
2 properties
response.Response-array_governor_GovernorVaasResponse
object
2 properties
governor.GovConfigfTokens
object
3 properties
guardian_sets.GuardianAddress
object
2 properties
governor.NotionalAvailable
object
2 properties
governor.EnqueuedVAA
object
4 properties
protocols.ProtocolNetworkPairVolume
object
3 properties
stats.TokenResult
object
5 properties
transactions.TransactionDetail
object
12 properties
governor.EnqueuedVaa
object
5 properties
response.Response-array_governor_GovernorLimit
object
2 properties
response.Response-guardian_sets_GuardianSetDoc
object
2 properties
stats.TopSymbolByVolumeResult
object
1 property
vaa.ChainID
integer
relays.RelayResponse
object
7 properties
stats.TopCorridorsResult
object
1 property
observations.ObservationDoc
object
10 properties
stats.TopCorridor
object
5 properties
relays.RelayDataResponse
object
5 properties
response.APIError
object
3 properties
response.Response-address_AddressOverview
object
2 properties
stats.NativeTokenTransferTopAddress
object
2 properties
transactions.ChainActivity
object
1 property
governor.NotionalLimitDetail
object
7 properties
response.Response-array_governor_NotionalAvailable
object
2 properties
response.Response-array_governor_EnqueuedVaaDetail
object
2 properties
stats.NativeTokenTransferByTime
object
3 properties
transactions.AttributeDoc
object
2 properties
stats.NativeTokenTransferActivity
object
4 properties
stats.Token
object
21 properties
operations.Content
object
3 properties
vaa.VaaDoc
object
15 properties
response.ResponsePagination
object
1 property
parser.StandardizedProperties
object
12 properties
protocols.ProtocolTrendingTokensResult
object
3 properties
protocols.ProtocolTrendingTokensResponse
object
2 properties
transactions.TopChainPairsResponse
object
1 property
governor.GovernorLimit
object
4 properties
workflow.EventType
string
transactions.OriginTx
object
4 properties
governor.EnqueuedVaaDetail
object
6 properties
response.Response-array_governor_EnqueuedVaas
object
2 properties
transactions.ScorecardsResponse
object
14 properties
operations.TargetChain
object
10 properties
stats.TopSymbolResult
object
4 properties
response.Response-array_governor_NotionalAvailableDetail
object
2 properties
governor.GovConfig
object
7 properties
operations.StandardizedProperties
object
12 properties
governor.EnqueuedVaas
object
2 properties
transactions.Destination
object
3 properties
response.Response-array_governor_NotionalLimitDetail
object
2 properties
vaa.VaaStats
object
2 properties
operations.Data
object
2 properties
operations.Vaa
object
3 properties
relays.DeliveryReponse
object
5 properties
relays.ResultExecutionResponse
object
6 properties
stats.NativeTokenTransferTopHolder
object
3 properties
transactions.ChainPair
object
3 properties
protocols.ProtocolTrendingToken
object
7 properties
transactions.ChainActivityTopResult
object
6 properties
transactions.GlobalTransactionDoc
object
3 properties
operations.OperationResponse
object
9 properties
relays.InstructionsResponse
object
11 properties
delegate_observations.DelegateObservationDoc
object
18 properties
governor.GovernorVaasResponse
object
8 properties
operations.EmitterAddress
object
2 properties
response.ErrorDetail
object
2 properties
transactions.Token
object
3 properties
stats.NativeTokenTransferSummary
object
11 properties
governor.MaxNotionalAvailableRecord
object
7 properties
governor.GovStatusChains
object
3 properties
governor.NotionalAvailableDetail
object
6 properties
transactions.ListTransactionsResponse
object
1 property
transactions.TransactionCountResult
object
2 properties
governor.Emitter
object
3 properties
stats.image
object
3 properties
protocols.ProtocolNetworkPairResponse
object
2 properties
github_com_wormhole-foundation_wormhole-explorer_api_routes_wormscan_operations.BalanceChanges
object
3 properties
transactions.AssetWithVolume
object
5 properties
supply.SupplyInfoResponse
object
2 properties
governor.GovStatusChainEmitter
object
3 properties
operations.SourceChain
object
11 properties
workflow.Event
object
8 properties
transactions.Tx
object
4 properties
governor.GovConfigChains
object
3 properties
parser.ParseVaaWithStandarizedPropertiesdResponse
object
2 properties
transactions.TopAssetsResponse
object
1 property
protocols.ProtocolNetworkPairResult
object
3 properties
response.Response-array_vaa_VaaDoc
object
2 properties
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Wormhole 6
Other APIs Wormhole publishes across the network.
Wormholescan Testnet API
Wormhole TypeScript SDK
Wormhole Connect Widget
Wormhole CLI
Wormhole Guardian API
Wormhole wormhole API
#wormholescan