Wormholescan API
Last updated
Was this helpful?
Last updated
Was this helpful?
Wormhole Guardian API This is the API for the Wormhole Guardian and Explorer. The API has two namespaces: wormholescan and guardian. wormholescan is the namespace for the explorer and the new endpoints. The prefix is /api/v1. guardian is the legacy namespace backguard compatible with guardian node API. The prefix is /v1. This API is public and does not require authentication although some endpoints are rate limited. Check each endpoint documentation for more information.
Contact information: API Support [email protected]
License:
Description
Lookup an address
Parameters
address
path
address
Yes
string
page
query
Page number. Starts at 0.
No
integer
pageSize
query
Number of elements per page.
No
integer
Responses
200
OK
400
Bad Request
404
Not Found
500
Internal Server Error
Description
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 chain when the VAA is emitted. The second transaction is created on the destination chain when the VAA is redeemed. If the response only contains an origin tx the VAA was not redeemed.
Parameters
chain_id
path
id of the blockchain
Yes
integer
emitter
path
address of the emitter
Yes
string
seq
path
sequence of the VAA
Yes
integer
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Returns governor configuration for all guardians.
Parameters
page
query
Page number.
No
integer
pageSize
query
Number of elements per page.
No
integer
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Returns governor configuration for a given guardian.
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Returns enqueued VAAs for each blockchain.
Parameters
page
query
Page number.
No
integer
pageSize
query
Number of elements per page.
No
integer
sortOrder
query
Sort results in ascending or descending order.
No
string
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Returns all enqueued VAAs for a given blockchain.
Parameters
page
query
Page number.
No
integer
pageSize
query
Number of elements per page.
No
integer
sortOrder
query
Sort results in ascending or descending order.
No
string
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Returns the governor limit for all blockchains.
Parameters
page
query
Page number.
No
integer
pageSize
query
Number of elements per page.
No
integer
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Returns the amount of notional value available for each blockchain.
Parameters
page
query
Page number.
No
integer
pageSize
query
Number of elements per page.
No
integer
sortOrder
query
Sort results in ascending or descending order.
No
string
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Returns the amount of notional value available for a given blockchain.
Parameters
page
query
Page number.
No
integer
pageSize
query
Number of elements per page.
No
integer
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Returns the detailed notional limit for all blockchains.
Parameters
page
query
Page number.
No
integer
pageSize
query
Number of elements per page.
No
integer
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Returns the detailed notional limit available for a given blockchain.
Parameters
page
query
Page number.
No
integer
pageSize
query
Number of elements per page.
No
integer
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Returns the maximum amount of notional value available for a given blockchain.
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Returns the governor status for all guardians.
Parameters
page
query
Page number.
No
integer
pageSize
query
Number of elements per page.
No
integer
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Returns the governor status for a given guardian.
Parameters
page
query
Page number.
No
integer
pageSize
query
Number of elements per page.
No
integer
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Health check
Responses
200
OK
{ "status": string }
400
Bad Request
500
Internal Server Error
Description
Returns the number of transactions by a defined time span and sample rate.
Parameters
timeSpan
query
Time Span, default: 1d, supported values: [1d, 1w, 1mo]. 1mo ​​is 30 days.
No
string
sampleRate
query
Sample Rate, default: 1h, supported values: [1h, 1d]. Valid configurations with timeSpan: 1d/1h, 1w/1d, 1mo/1d
No
string
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Returns all observations, sorted in descending timestamp order.
Parameters
page
query
Page number.
No
integer
pageSize
query
Number of elements per page.
No
integer
sortOrder
query
Sort results in ascending or descending order.
No
string
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Returns all observations for a given blockchain, sorted in descending timestamp order.
Parameters
page
query
Page number.
No
integer
pageSize
query
Number of elements per page.
No
integer
sortOrder
query
Sort results in ascending or descending order.
No
string
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Returns all observations for a specific emitter address, sorted in descending timestamp order.
Parameters
page
query
Page number.
No
integer
pageSize
query
Number of elements per page.
No
integer
sortOrder
query
Sort results in ascending or descending order.
No
string
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Find observations identified by emitter chain, emitter address and sequence.
Parameters
page
query
Page number.
No
integer
pageSize
query
Number of elements per page.
No
integer
sortOrder
query
Sort results in ascending or descending order.
No
string
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Find a specific observation.
Parameters
page
query
Page number.
No
integer
pageSize
query
Number of elements per page.
No
integer
sortOrder
query
Sort results in ascending or descending order.
No
string
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Find all operations.
Parameters
address
query
address of the emitter
No
string
txHash
query
hash of the transaction
No
string
page
query
page number
No
integer
pageSize
query
pageSize
No
integer
sourceChain
query
source chains of the operation, separated by comma
No
string
targetChain
query
target chains of the operation, separated by comma
No
string
appId
query
appID of the operation
No
string
exclusiveAppId
query
single appId of the operation
No
boolean
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Find operations by ID (chainID/emitter/sequence).
Parameters
chain_id
path
id of the blockchain
Yes
integer
emitter
path
address of the emitter
Yes
string
seq
path
sequence of the VAA
Yes
integer
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Returns the representative stats for the top protocols
Responses
200
OK
500
Internal Server Error
Description
Ready check
Responses
200
OK
{ "ready": string }
400
Bad Request
500
Internal Server Error
Description
Get a specific relay information by chainID, emitter address and sequence.
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
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 volume transferred through the token bridge in the last 24 hours, in USD. Total Tx count is the number of transaction bridging assets since the creation of the network (does not include Pyth or other messages). 24h tx count is the number of transaction bridging assets in the last 24 hours (does not include Pyth or other messages). Total messages is the number of VAAs emitted since the creation of the network (includes Pyth messages).
Responses
200
OK
500
Internal Server Error
Description
Returns a token symbol, coingecko id and address by chain and token address.
Parameters
chain_id
path
id of the blockchain
Yes
integer
token_address
path
token address
Yes
string
Responses
200
OK
400
Bad Request
404
Not Found
Description
Returns a list of the top 100 tokens, sorted in descending order by the number of transactions.
Parameters
timeSpan
query
Time span, supported values: 2d and 7d (default is 2d).
No
string
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Returns a list of emitter_chain 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.
Parameters
timeSpan
query
Time span, supported values: 7d, 15d, 30d.
Yes
string
Responses
200
OK
500
Internal Server Error
Description
Returns a list of the emitter_chain and destination_chain pair ordered by transfer count.
Parameters
timeSpan
query
Time span, supported values: 7d, 15d, 30d.
Yes
string
Responses
200
OK
500
Internal Server Error
Description
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.
Parameters
timeSpan
query
Time span, supported values: 7d, 15d and 30d (default is 7d).
No
string
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Returns transactions. Output is paginated.
Parameters
page
query
Page number. Starts at 0.
No
integer
pageSize
query
Number of elements per page.
No
integer
sortOrder
query
Sort results in ascending or descending order.
No
string
address
query
Filter transactions by Address.
No
string
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Find VAA metadata by ID.
Parameters
chain_id
path
id of the blockchain
Yes
integer
emitter
path
address of the emitter
Yes
string
seq
path
sequence of the VAA
Yes
integer
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Returns all VAAs. Output is paginated and can also be be sorted.
Parameters
page
query
Page number.
No
integer
pageSize
query
Number of elements per page.
No
integer
sortOrder
query
Sort results in ascending or descending order.
No
string
txHash
query
Transaction hash of the VAA
No
string
parsedPayload
query
include the parsed contents of the VAA, if available
No
boolean
appId
query
filter by application ID
No
string
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Returns all the VAAs generated in specific blockchain.
Parameters
chain_id
path
id of the blockchain
Yes
integer
page
query
Page number.
No
integer
pageSize
query
Number of elements per page.
No
integer
sortOrder
query
Sort results in ascending or descending order.
No
string
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Returns all all the VAAs generated by a specific emitter address.
Parameters
chain_id
path
id of the blockchain
Yes
integer
emitter
path
address of the emitter
Yes
string
toChain
query
destination chain
No
integer
page
query
Page number.
No
integer
pageSize
query
Number of elements per page.
No
integer
sortOrder
query
Sort results in ascending or descending order.
No
string
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Find a VAA by ID.
Parameters
chain_id
path
id of the blockchain
Yes
integer
emitter
path
address of the emitter
Yes
string
seq
path
sequence of the VAA
Yes
integer
parsedPayload
query
include the parsed contents of the VAA, if available
No
boolean
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Find duplicated VAA by ID.
Parameters
chain_id
path
id of the blockchain
Yes
integer
emitter
path
address of the emitter
Yes
string
seq
path
sequence of the VAA
Yes
integer
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Parse a VAA.
Responses
200
OK
400
Bad Request
404
Not Found
500
Internal Server Error
Description
Returns the total number of VAAs emitted for each blockchain.
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Get version/release information.
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
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 the day the VAA was emitted.
Parameters
timeSpan
query
Time span, supported values: 7d, 30d, 90d, 1y and all-time (default is 7d).
No
string
by
query
Renders the results using notional or tx count (default is notional).
No
string
apps
query
List of apps separated by comma (default is all apps).
No
string
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Search for a specific period of time the number of transactions and the volume.
Parameters
timespan
query
Time span, supported values: 1d, 1mo and 1y
Yes
string
from
query
From date, supported format 2006-01-02T15:04:05Z07:00
Yes
string
to
query
To date, supported format 2006-01-02T15:04:05Z07:00
Yes
string
appId
query
Search by appId
No
string
sourceChain
query
Search by sourceChain
No
string
targetChain
query
Search by targetChain
No
string
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Returns the swagger specification for this API.
Responses
200
OK
object
400
Bad Request
500
Internal Server Error
Description
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 number of remainingAvailableNotional values in the GovernorConfig collection. N = number of guardians for a chainID. The smallest remainingAvailableNotional value for a chainID is used for the endpoint response.
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Get enqueued VAAs
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Check if vaa is enqueued
Parameters
chain_id
path
id of the blockchain
Yes
integer
emitter
path
address of the emitter
Yes
string
seq
path
sequence of the vaa
Yes
integer
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
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 originChainId and originAddress and different price values for each node, the price that has most occurrences in all the nodes for an originChainId and originAddress is returned.
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Get current guardian set.
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
Get heartbeats for guardians
Responses
200
OK
400
Bad Request
500
Internal Server Error
Description
get a batch of VAA []byte from a chainID, emitter address and sequence.
Parameters
chain_id
path
id of the blockchain
Yes
integer
emitter
path
address of the emitter
Yes
string
seq
path
sequence of the VAA
Yes
integer
Responses
200
OK
{ "vaaBytes": [ integer ] }
400
Bad Request
500
Internal Server Error
Description
get a VAA []byte from a chainID, emitter address and sequence.
Parameters
chain_id
path
id of the blockchain
Yes
integer
emitter
path
address of the emitter
Yes
string
seq
path
sequence of the VAA
Yes
integer
Responses
200
OK
{ "vaaBytes": [ integer ] }
400
Bad Request
500
Internal Server Error
vaas
No
addresses
[ string ]
No
index
integer
No
bigTransactionSize
string
No
chainId
No
notionalLimit
string
No
remainingAvailableNotional
string
No
entries
No
emitterAddress
string
No
enqueuedVaas
No
totalEnqueuedVaas
integer
No
notionalValue
integer
No
releaseTime
string
No
sequence
string
No
txHash
string
No
chainId
No
emitterAddress
string
No
notionalValue
integer
No
sequence
string
No
txHash
string
No
chainId
No
emitterAddress
string
No
notionalValue
integer
No
releaseTime
integer
No
sequence
string
No
txHash
string
No
emitterAddress
string
No
emitterChain
No
notionalValue
string
No
releaseTime
integer
No
sequence
integer
No
txHash
string
No
entries
No
chainId
No
enqueuedVaas
No
chains
No
counter
integer
No
createdAt
string
No
id
string
No
nodeName
string
No
tokens
No
updatedAt
string
No
bigTransactionSize
integer
No
chainId
No
notionalLimit
integer
No
originAddress
string
No
originChainId
integer
No
price
number
No
chains
No
createdAt
string
No
id
string
No
nodeName
string
No
updatedAt
string
No
emitterAddress
string
No
enqueuedVaas
No
totalEnqueuedVaas
integer
No
chainId
No
emitters
No
remainingAvailableNotional
integer
No
availableNotional
integer
No
chainId
No
maxTransactionSize
integer
No
notionalLimit
integer
No
availableNotional
integer
No
chainId
No
createdAt
string
No
emitters
No
id
string
No
nodeName
string
No
updatedAt
string
No
availableNotional
integer
No
chainId
No
availableNotional
integer
No
chainId
No
createdAt
string
No
id
string
No
nodeName
string
No
updatedAt
string
No
chainId
No
createdAt
string
No
id
string
No
maxTransactionSize
integer
No
nodeName
string
No
notionalLimit
integer
No
updatedAt
string
No
originAddress
string
No
originChainId
No
price
number
No
guardianSet
No
contractAddress
string
No
errorCount
string
No
height
string
No
id
integer
No
p2pNodeAddr
string
No
rawHeartbeat
No
verifiedGuardianAddr
string
No
entries
No
bootTimestamp
string
No
counter
string
No
features
[ string ]
No
guardianAddr
string
No
networks
No
nodeName
string
No
timestamp
string
No
version
string
No
branch
string
No
build
string
No
build_date
string
No
machine
string
No
user
string
No
emitterAddr
string
No
emitterChain
No
guardianAddr
string
No
hash
[ integer ]
No
id
string
No
indexedAt
string
No
sequence
string
No
signature
[ integer ]
No
txHash
[ integer ]
No
updatedAt
string
No
payload
object
No
standarizedProperties
No
type
string
No
value
object
No
hex
string
No
native
string
No
content
No
data
object
No
emitterAddress
No
emitterChain
No
id
string
No
sequence
string
No
sourceChain
No
targetChain
No
vaa
No
attribute
No
chainId
No
from
string
No
status
string
No
timestamp
string
No
transaction
No
amount
string
No
appIds
[ string ]
No
fee
string
No
feeAddress
string
No
feeChain
No
fromAddress
string
No
fromChain
No
toAddress
string
No
toChain
No
tokenAddress
string
No
tokenChain
No
chainId
No
from
string
No
status
string
No
timestamp
string
No
to
string
No
transaction
No
secondTxHash
string
No
txHash
string
No
guardianSetIndex
integer
No
isDuplicated
boolean
No
raw
[ integer ]
No
parsedPayload
No
standardizedProperties
No
amount
string
No
appIds
[ string ]
No
fee
string
No
feeAddress
string
No
feeChain
No
fromAddress
string
No
fromChain
No
toAddress
string
No
toChain
No
tokenAddress
string
No
tokenChain
No
error
string
No
last_day_diff_percentage
string
No
last_day_messages
integer
No
protocol
string
No
total_messages
integer
No
total_value_locked
number
No
total_value_secured
number
No
total_value_transferred
number
No
budget
string
No
execution
No
maxRefund
string
No
relayGasUsed
integer
No
targetChainDecimals
integer
No
encodedExecutionInfo
string
No
extraReceiverValue
{ "_hex": string, "_isBigNumber": boolean }
No
refundAddress
string
No
refundChainId
integer
No
refundDeliveryProvider
string
No
requestedReceiverValue
{ "_hex": string, "_isBigNumber": boolean }
No
senderAddress
string
No
sourceDeliveryProvider
string
No
targetAddress
string
No
targetChainId
integer
No
vaaKeys
[ ]
No
delivery
No
fromTxHash
string
No
instructions
No
maxAttempts
integer
No
toTxHash
string
No
completedAt
string
No
data
No
failedAt
string
No
id
string
No
receivedAt
string
No
relayer
string
No
status
string
No
detail
string
No
gasUsed
string
No
refundStatus
string
No
revertString
string
No
status
string
No
transactionHash
string
No
data
No
pagination
No
data
No
pagination
No
data
No
pagination
No
data
No
pagination
No
data
No
pagination
No
data
No
pagination
No
data
No
pagination
No
data
No
pagination
No
data
No
pagination
No
data
No
pagination
No
data
No
pagination
No
data
No
pagination
No
data
No
pagination
No
next
string
No
emitter_chain
No
token_address
string
No
token_chain
No
txs
number
No
volume
number
No
emitter_chain
No
target_chain
No
token_address
string
No
token_chain
No
txs
integer
No
corridors
No
symbols
No
symbol
string
No
tokens
No
txs
number
No
volume
number
No
emitterChain
No
symbol
string
No
tokenAddress
string
No
tokenChain
No
volume
string
No
type
string
No
value
object
No
txs
No
count
integer
No
destination_chain
string
No
emitter_chain
string
No
from
string
No
to
string
No
volume
integer
No
destinationChain
No
emitterChain
No
numberOfTransfers
string
No
chain
integer
No
percentage
number
No
volume
number
No
blockNumber
string
No
chainId
No
from
string
No
method
string
No
status
string
No
timestamp
string
No
to
string
No
txHash
string
No
updatedAt
string
No
destinationTx
No
id
string
No
originTx
No
transactions
No
attribute
No
from
string
No
status
string
No
txHash
string
No
24h_messages
string
Number of VAAs emitted in the last 24 hours (includes Pyth messages).
No
24h_tx_count
string
Number of VAAs emitted in the last 24 hours (does not include Pyth messages).
No
24h_volume
string
Volume transferred through the token bridge in the last 24 hours, in USD.
No
total_messages
string
Number of VAAs emitted since the creation of the network (includes Pyth messages).
No
total_tx_count
string
Number of VAAs emitted since the creation of the network (does not include Pyth messages)
No
total_volume
string
No
tvl
string
Total value locked in USD.
No
coingeckoId
string
No
decimals
integer
No
symbol
string
No
assets
No
chainPairs
No
count
integer
No
time
string
No
emitterAddress
string
EmitterAddress contains the VAA's emitter address, encoded in hex.
No
emitterChain
No
emitterNativeAddress
string
EmitterNativeAddress contains the VAA's emitter address, encoded in the emitter chain's native format.
No
globalTx
No
id
string
No
payload
object
No
standardizedProperties
object
No
symbol
string
No
timestamp
string
No
tokenAmount
string
No
txHash
string
No
usdAmount
string
No
chain
integer
No
destinations
No
percentage
number
No
volume
number
No
vaa.ChainID
integer
appId
string
AppId is an extension field - it is not present in the guardian API.
No
digest
string
No
emitterAddr
string
No
emitterChain
No
emitterNativeAddr
string
No
guardianSetIndex
integer
No
id
string
No
indexedAt
string
No
isDuplicated
boolean
No
payload
object
Payload is an extension field - it is not present in the guardian API.
No
timestamp
string
No
txHash
string
TxHash is an extension field - it is not present in the guardian API.
No
updatedAt
string
No
vaa
[ integer ]
No
version
integer
No
chainId
No
count
integer
No
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]
[ ]