openapi: 3.1.0
info:
title: Data AVAX Supply EVM Chains API
description: The Data API provides web3 application developers with multi-chain data related to Avalanche's primary network, Avalanche subnets, and Ethereum. With Data API, you can easily build products that leverage real-time and historical transaction and transfer history, native and token balances, and various types of token metadata. The API is in Beta and may be subject to change.If you have feedback or feature requests for the API, please submit them here. Bug reports can be submitted here, and any potential security issues can be reported here.
version: 1.0.0
contact: {}
servers:
- url: https://glacier-api.avax.network
security:
- apiKey: []
- {}
tags:
- name: EVM Chains
description: Find information about indexed EVM-compatible chains, such as the Avalanche C-Chain.
paths:
/v1/address/{address}/chains:
get:
operationId: listAddressChains
x-speakeasy-group: data.evm.address.chains
x-speakeasy-name-override: list
summary: List all chains associated with a given address
description: Lists the chains where the specified address has participated in transactions or ERC token transfers, either as a sender or receiver. The data is refreshed every 15 minutes.
parameters:
- name: address
required: true
in: path
description: A wallet address.
example: '0x71C7656EC7ab88b098defB751B7401B5f6d8976F'
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/ListAddressChainsResponse'
'400':
description: "Bad requests generally mean the client has passed invalid \n or malformed parameters. Error messages in the response could help in \n evaluating the error."
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequest'
'401':
description: "When a client attempts to access resources that require \n authorization credentials but the client lacks proper authentication \n in the request, the server responds with 401."
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
'403':
description: "When a client attempts to access resources with valid\n credentials but doesn't have the privilege to perform that action, \n the server responds with 403."
content:
application/json:
schema:
$ref: '#/components/schemas/Forbidden'
'404':
description: "The error is mostly returned when the client requests\n with either mistyped URL, or the passed resource is moved or deleted, \n or the resource doesn't exist."
content:
application/json:
schema:
$ref: '#/components/schemas/NotFound'
'429':
description: "This error is returned when the client has sent too many,\n and has hit the rate limit."
content:
application/json:
schema:
$ref: '#/components/schemas/TooManyRequests'
'500':
description: "The error is a generic server side error that is \n returned for any uncaught and unexpected issues on the server side. \n This should be very rare, and you may reach out to us if the problem \n persists for a longer duration."
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerError'
'502':
description: "This is an internal error indicating invalid response \n received by the client-facing proxy or gateway from the upstream server."
content:
application/json:
schema:
$ref: '#/components/schemas/BadGateway'
'503':
description: "The error is returned for certain routes on a particular\n Subnet. This indicates an internal problem with our Subnet node, and may \n not necessarily mean the Subnet is down or affected."
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceUnavailable'
tags:
- EVM Chains
x-codeSamples:
- lang: javascript
label: JavaScript
source: "import { Avalanche } from \"@avalanche-sdk/chainkit\";\n\nconst avalanche = new Avalanche();\n\nasync function run() {\n const result = await avalanche.data.evm.address.chains.list({\n address: \"0x71C7656EC7ab88b098defB751B7401B5f6d8976F\",\n });\n\n console.log(result);\n}\n\nrun();"
/v1/chains:
get:
operationId: supportedChains
x-speakeasy-name-override: list
x-speakeasy-group: data.evm.chains
x-execution-weight: free
summary: List chains
description: Lists the AvaCloud supported EVM-compatible chains. Filterable by network.
parameters:
- name: network
required: false
in: query
description: Either mainnet or testnet/fuji.
example: mainnet
schema:
$ref: '#/components/schemas/Network'
- name: feature
required: false
in: query
description: Filter by feature.
example: nftIndexing
schema:
$ref: '#/components/schemas/ApiFeature'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/ListChainsResponse'
'400':
description: "Bad requests generally mean the client has passed invalid \n or malformed parameters. Error messages in the response could help in \n evaluating the error."
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequest'
'401':
description: "When a client attempts to access resources that require \n authorization credentials but the client lacks proper authentication \n in the request, the server responds with 401."
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
'403':
description: "When a client attempts to access resources with valid\n credentials but doesn't have the privilege to perform that action, \n the server responds with 403."
content:
application/json:
schema:
$ref: '#/components/schemas/Forbidden'
'404':
description: "The error is mostly returned when the client requests\n with either mistyped URL, or the passed resource is moved or deleted, \n or the resource doesn't exist."
content:
application/json:
schema:
$ref: '#/components/schemas/NotFound'
'429':
description: "This error is returned when the client has sent too many,\n and has hit the rate limit."
content:
application/json:
schema:
$ref: '#/components/schemas/TooManyRequests'
'500':
description: "The error is a generic server side error that is \n returned for any uncaught and unexpected issues on the server side. \n This should be very rare, and you may reach out to us if the problem \n persists for a longer duration."
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerError'
'502':
description: "This is an internal error indicating invalid response \n received by the client-facing proxy or gateway from the upstream server."
content:
application/json:
schema:
$ref: '#/components/schemas/BadGateway'
'503':
description: "The error is returned for certain routes on a particular\n Subnet. This indicates an internal problem with our Subnet node, and may \n not necessarily mean the Subnet is down or affected."
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceUnavailable'
tags:
- EVM Chains
x-codeSamples:
- lang: javascript
label: JavaScript
source: "import { Avalanche } from \"@avalanche-sdk/chainkit\";\n\nconst avalanche = new Avalanche();\n\nasync function run() {\n const result = await avalanche.data.evm.chains.list({\n network: \"mainnet\",\n feature: \"nftIndexing\",\n });\n\n console.log(result);\n}\n\nrun();"
/v1/chains/{chainId}:
get:
operationId: getChainInfo
x-speakeasy-name-override: get
x-speakeasy-group: data.evm.chains
x-execution-weight: free
summary: Get chain information
description: Gets chain information for the EVM-compatible chain if supported by AvaCloud.
parameters:
- name: chainId
required: true
in: path
description: A supported evm chain id or blockchain id. Use the `/chains` endpoint to get a list of supported chain ids.
example: '43114'
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/GetChainResponse'
'400':
description: "Bad requests generally mean the client has passed invalid \n or malformed parameters. Error messages in the response could help in \n evaluating the error."
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequest'
'401':
description: "When a client attempts to access resources that require \n authorization credentials but the client lacks proper authentication \n in the request, the server responds with 401."
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
'403':
description: "When a client attempts to access resources with valid\n credentials but doesn't have the privilege to perform that action, \n the server responds with 403."
content:
application/json:
schema:
$ref: '#/components/schemas/Forbidden'
'404':
description: "The error is mostly returned when the client requests\n with either mistyped URL, or the passed resource is moved or deleted, \n or the resource doesn't exist."
content:
application/json:
schema:
$ref: '#/components/schemas/NotFound'
'429':
description: "This error is returned when the client has sent too many,\n and has hit the rate limit."
content:
application/json:
schema:
$ref: '#/components/schemas/TooManyRequests'
'500':
description: "The error is a generic server side error that is \n returned for any uncaught and unexpected issues on the server side. \n This should be very rare, and you may reach out to us if the problem \n persists for a longer duration."
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerError'
'502':
description: "This is an internal error indicating invalid response \n received by the client-facing proxy or gateway from the upstream server."
content:
application/json:
schema:
$ref: '#/components/schemas/BadGateway'
'503':
description: "The error is returned for certain routes on a particular\n Subnet. This indicates an internal problem with our Subnet node, and may \n not necessarily mean the Subnet is down or affected."
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceUnavailable'
tags:
- EVM Chains
x-codeSamples:
- lang: javascript
label: JavaScript
source: "import { Avalanche } from \"@avalanche-sdk/chainkit\";\n\nconst avalanche = new Avalanche({\n chainId: \"43114\",\n});\n\nasync function run() {\n const result = await avalanche.data.evm.chains.get({});\n\n console.log(result);\n}\n\nrun();"
/v1/chains/address/{address}:
get:
operationId: getAddressChains
x-speakeasy-group: data.evm.chains
x-execution-weight: free
description: '**[Deprecated]** Gets a list of all chains where the address was either a sender or receiver in a transaction or ERC transfer. The list is currently updated every 15 minutes.
⚠️ **This operation will be removed in a future release. Please use /v1/address/:address/chains endpoint instead** .'
deprecated: true
parameters:
- name: address
required: true
in: path
description: A wallet address.
example: '0x71C7656EC7ab88b098defB751B7401B5f6d8976F'
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/ListAddressChainsResponse'
'400':
description: "Bad requests generally mean the client has passed invalid \n or malformed parameters. Error messages in the response could help in \n evaluating the error."
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequest'
'401':
description: "When a client attempts to access resources that require \n authorization credentials but the client lacks proper authentication \n in the request, the server responds with 401."
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
'403':
description: "When a client attempts to access resources with valid\n credentials but doesn't have the privilege to perform that action, \n the server responds with 403."
content:
application/json:
schema:
$ref: '#/components/schemas/Forbidden'
'404':
description: "The error is mostly returned when the client requests\n with either mistyped URL, or the passed resource is moved or deleted, \n or the resource doesn't exist."
content:
application/json:
schema:
$ref: '#/components/schemas/NotFound'
'429':
description: "This error is returned when the client has sent too many,\n and has hit the rate limit."
content:
application/json:
schema:
$ref: '#/components/schemas/TooManyRequests'
'500':
description: "The error is a generic server side error that is \n returned for any uncaught and unexpected issues on the server side. \n This should be very rare, and you may reach out to us if the problem \n persists for a longer duration."
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerError'
'502':
description: "This is an internal error indicating invalid response \n received by the client-facing proxy or gateway from the upstream server."
content:
application/json:
schema:
$ref: '#/components/schemas/BadGateway'
'503':
description: "The error is returned for certain routes on a particular\n Subnet. This indicates an internal problem with our Subnet node, and may \n not necessarily mean the Subnet is down or affected."
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceUnavailable'
tags:
- EVM Chains
/v1/chains/allTransactions:
get:
operationId: listAllLatestTransactions
x-speakeasy-pagination:
type: cursor
inputs:
- name: pageToken
in: parameters
type: cursor
outputs:
nextCursor: $.nextPageToken
x-speakeasy-group: data.evm.chains
x-execution-weight: free
description: '**[Deprecated]** Lists the latest transactions for all supported EVM chains. Filterable by status.
⚠️ **This operation will be removed in a future release. Please use /v1/transactions endpoint instead** .'
deprecated: true
parameters:
- name: pageToken
required: false
in: query
description: A page token, received from a previous list call. Provide this to retrieve the subsequent page.
schema:
type: string
- name: pageSize
required: false
in: query
description: The maximum number of items to return. The minimum page size is 1. The maximum pageSize is 100.
schema:
type: integer
default: 10
minimum: 1
maximum: 100
example: '10'
- name: network
required: false
in: query
description: Either mainnet or testnet/fuji.
example: mainnet
schema:
$ref: '#/components/schemas/Network'
- name: status
required: false
in: query
description: A status filter for listed transactions.
schema:
$ref: '#/components/schemas/TransactionStatus'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/ListNativeTransactionsResponse'
'400':
description: "Bad requests generally mean the client has passed invalid \n or malformed parameters. Error messages in the response could help in \n evaluating the error."
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequest'
'401':
description: "When a client attempts to access resources that require \n authorization credentials but the client lacks proper authentication \n in the request, the server responds with 401."
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
'403':
description: "When a client attempts to access resources with valid\n credentials but doesn't have the privilege to perform that action, \n the server responds with 403."
content:
application/json:
schema:
$ref: '#/components/schemas/Forbidden'
'404':
description: "The error is mostly returned when the client requests\n with either mistyped URL, or the passed resource is moved or deleted, \n or the resource doesn't exist."
content:
application/json:
schema:
$ref: '#/components/schemas/NotFound'
'429':
description: "This error is returned when the client has sent too many,\n and has hit the rate limit."
content:
application/json:
schema:
$ref: '#/components/schemas/TooManyRequests'
'500':
description: "The error is a generic server side error that is \n returned for any uncaught and unexpected issues on the server side. \n This should be very rare, and you may reach out to us if the problem \n persists for a longer duration."
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerError'
'502':
description: "This is an internal error indicating invalid response \n received by the client-facing proxy or gateway from the upstream server."
content:
application/json:
schema:
$ref: '#/components/schemas/BadGateway'
'503':
description: "The error is returned for certain routes on a particular\n Subnet. This indicates an internal problem with our Subnet node, and may \n not necessarily mean the Subnet is down or affected."
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceUnavailable'
tags:
- EVM Chains
/v1/chains/allBlocks:
get:
operationId: listAllLatestBlocks
x-speakeasy-pagination:
type: cursor
inputs:
- name: pageToken
in: parameters
type: cursor
outputs:
nextCursor: $.nextPageToken
x-speakeasy-group: data.evm.chains
x-execution-weight: free
description: '**[Deprecated]** Lists the latest blocks for all supported EVM chains. Filterable by network.
⚠️ **This operation will be removed in a future release. Please use /v1/blocks endpoint instead** .'
deprecated: true
parameters:
- name: pageToken
required: false
in: query
description: A page token, received from a previous list call. Provide this to retrieve the subsequent page.
schema:
type: string
- name: pageSize
required: false
in: query
description: The maximum number of items to return. The minimum page size is 1. The maximum pageSize is 100.
schema:
type: integer
default: 10
minimum: 1
maximum: 100
example: '10'
- name: network
required: false
in: query
description: Either mainnet or testnet/fuji.
example: mainnet
schema:
$ref: '#/components/schemas/Network'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/ListEvmBlocksResponse'
'400':
description: "Bad requests generally mean the client has passed invalid \n or malformed parameters. Error messages in the response could help in \n evaluating the error."
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequest'
'401':
description: "When a client attempts to access resources that require \n authorization credentials but the client lacks proper authentication \n in the request, the server responds with 401."
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
'403':
description: "When a client attempts to access resources with valid\n credentials but doesn't have the privilege to perform that action, \n the server responds with 403."
content:
application/json:
schema:
$ref: '#/components/schemas/Forbidden'
'404':
description: "The error is mostly returned when the client requests\n with either mistyped URL, or the passed resource is moved or deleted, \n or the resource doesn't exist."
content:
application/json:
schema:
$ref: '#/components/schemas/NotFound'
'429':
description: "This error is returned when the client has sent too many,\n and has hit the rate limit."
content:
application/json:
schema:
$ref: '#/components/schemas/TooManyRequests'
'500':
description: "The error is a generic server side error that is \n returned for any uncaught and unexpected issues on the server side. \n This should be very rare, and you may reach out to us if the problem \n persists for a longer duration."
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerError'
'502':
description: "This is an internal error indicating invalid response \n received by the client-facing proxy or gateway from the upstream server."
content:
application/json:
schema:
$ref: '#/components/schemas/BadGateway'
'503':
description: "The error is returned for certain routes on a particular\n Subnet. This indicates an internal problem with our Subnet node, and may \n not necessarily mean the Subnet is down or affected."
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceUnavailable'
tags:
- EVM Chains
/v2/chains:
get:
operationId: listChains
x-speakeasy-name-override: list
x-speakeasy-pagination:
type: cursor
inputs:
- name: pageToken
in: parameters
type: cursor
outputs:
nextCursor: $.nextPageToken
x-execution-weight: free
x-speakeasy-group: metrics.chains
x-codeSamples:
- lang: javascript
label: JavaScript
source: "import { Avalanche } from \"@avalanche-sdk/chainkit\";\n\nconst avalanche = new Avalanche();\n\nasync function run() {\n const result = await avalanche.metrics.chains.list({\n network: \"mainnet\",\n });\n\n for await (const page of result) {\n console.log(page);\n }\n}\n\nrun();"
summary: Get a list of supported blockchains
description: Get a list of Metrics API supported blockchains. This endpoint is paginated and supports a maximum page size of 10000.
parameters:
- name: pageToken
required: false
in: query
description: A page token, received from a previous list call. Provide this to retrieve the subsequent page.
schema:
type: string
- name: network
required: false
in: query
description: Either mainnet or testnet/fuji.
example: mainnet
schema:
$ref: '#/components/schemas/Network'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/ListChainsResponse_2'
'400':
description: "Bad requests generally mean the client has passed invalid \n or malformed parameters. Error messages in the response could help in \n evaluating the error."
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequest'
'401':
description: "When a client attempts to access resources that require \n authorization credentials but the client lacks proper authentication \n in the request, the server responds with 401."
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
'403':
description: "When a client attempts to access resources with valid\n credentials but doesn't have the privilege to perform that action, \n the server responds with 403."
content:
application/json:
schema:
$ref: '#/components/schemas/Forbidden'
'404':
description: "The error is mostly returned when the client requests\n with either mistyped URL, or the passed resource is moved or deleted, \n or the resource doesn't exist."
content:
application/json:
schema:
$ref: '#/components/schemas/NotFound'
'429':
description: "This error is returned when the client has sent too many,\n and has hit the rate limit."
content:
application/json:
schema:
$ref: '#/components/schemas/TooManyRequests'
'500':
description: "The error is a generic server side error that is \n returned for any uncaught and unexpected issues on the server side. \n This should be very rare, and you may reach out to us if the problem \n persists for a longer duration."
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerError'
'502':
description: "This is an internal error indicating invalid response \n received by the client-facing proxy or gateway from the upstream server."
content:
application/json:
schema:
$ref: '#/components/schemas/BadGateway'
'503':
description: "The error is returned for certain routes on a particular\n Subnet. This indicates an internal problem with our Subnet node, and may \n not necessarily mean the Subnet is down or affected."
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceUnavailable'
tags:
- EVM Chains
/v2/chains/{chainId}:
get:
operationId: getChain
x-speakeasy-name-override: get
x-execution-weight: free
x-speakeasy-group: metrics.chains
summary: Get chain information for supported blockchain
x-codeSamples:
- lang: javascript
label: JavaScript
source: "import { Avalanche } from \"@avalanche-sdk/chainkit\";\n\nconst avalanche = new Avalanche({\n chainId: \"43114\",\n});\n\nasync function run() {\n const result = await avalanche.metrics.chains.get({});\n\n console.log(result);\n}\n\nrun();"
description: Get chain information for Metrics API supported blockchain.
parameters:
- name: chainId
required: true
in: path
description: A supported evm chain id. Use the `/chains` endpoint to get a list of supported chain ids.
example: '43114'
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/Chain'
'400':
description: "Bad requests generally mean the client has passed invalid \n or malformed parameters. Error messages in the response could help in \n evaluating the error."
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequest'
'401':
description: "When a client attempts to access resources that require \n authorization credentials but the client lacks proper authentication \n in the request, the server responds with 401."
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
'403':
description: "When a client attempts to access resources with valid\n credentials but doesn't have the privilege to perform that action, \n the server responds with 403."
content:
application/json:
schema:
$ref: '#/components/schemas/Forbidden'
'404':
description: "The error is mostly returned when the client requests\n with either mistyped URL, or the passed resource is moved or deleted, \n or the resource doesn't exist."
content:
application/json:
schema:
$ref: '#/components/schemas/NotFound'
'429':
description: "This error is returned when the client has sent too many,\n and has hit the rate limit."
content:
application/json:
schema:
$ref: '#/components/schemas/TooManyRequests'
'500':
description: "The error is a generic server side error that is \n returned for any uncaught and unexpected issues on the server side. \n This should be very rare, and you may reach out to us if the problem \n persists for a longer duration."
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerError'
'502':
description: "This is an internal error indicating invalid response \n received by the client-facing proxy or gateway from the upstream server."
content:
application/json:
schema:
$ref: '#/components/schemas/BadGateway'
'503':
description: "The error is returned for certain routes on a particular\n Subnet. This indicates an internal problem with our Subnet node, and may \n not necessarily mean the Subnet is down or affected."
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceUnavailable'
tags:
- EVM Chains
/v1/mapping:
get:
operationId: getMappings
x-execution-weight: free
x-speakeasy-group: metrics.chains
x-speakeasy-pagination:
type: cursor
inputs:
- name: startKey
in: parameters
type: cursor
outputs:
nextCursor: $.nextPageStartKey
x-speakeasy-ignore: true
description: Get a list of Metrics API supported mappings.
deprecated: true
parameters:
- name: from
required: false
in: query
description: From date in UNIX Timestamp.
example: 1654819200
schema:
type: string
- name: to
required: false
in: query
description: To date in UNIX Timestamp.
example: 1655424000
schema:
type: string
- name: startKey
required: false
in: query
description: For paginated responses. Value will be provided in the [nextPageStartKey] field in the response if the query has more than one page.
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/SubnetMappingsResponse'
'400':
description: "Bad requests generally mean the client has passed invalid \n or malformed parameters. Error messages in the response could help in \n evaluating the error."
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequest'
'401':
description: "When a client attempts to access resources that require \n authorization credentials but the client lacks proper authentication \n in the request, the server responds with 401."
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
'403':
description: "When a client attempts to access resources with valid\n credentials but doesn't have the privilege to perform that action, \n the server responds with 403."
content:
application/json:
schema:
$ref: '#/components/schemas/Forbidden'
'404':
description: "The error is mostly returned when the client requests\n with either mistyped URL, or the passed resource is moved or deleted, \n or the resource doesn't exist."
content:
application/json:
schema:
$ref: '#/components/schemas/NotFound'
'429':
description: "This error is returned when the client has sent too many,\n and has hit the rate limit."
content:
application/json:
schema:
$ref: '#/components/schemas/TooManyRequests'
'500':
description: "The error is a generic server side error that is \n returned for any uncaught and unexpected issues on the server side. \n This should be very rare, and you may reach out to us if the problem \n persists for a longer duration."
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerError'
'502':
description: "This is an internal error indicating invalid response \n received by the client-facing proxy or gateway from the upstream server."
content:
application/json:
schema:
$ref: '#/components/schemas/BadGateway'
'503':
description: "The error is returned for certain routes on a particular\n Subnet. This indicates an internal problem with our Subnet node, and may \n not necessarily mean the Subnet is down or affected."
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceUnavailable'
tags:
- EVM Chains
/v1/mapping/{subnetID}:
get:
operationId: getMappingsBySubnetId
x-execution-weight: free
x-speakeasy-group: metrics.chains
x-speakeasy-pagination:
type: cursor
inputs:
- name: startKey
in: parameters
type: cursor
outputs:
nextCursor: $.nextPageStartKey
x-speakeasy-ignore: true
description: Get a Metrics API supported mapping by subnet ID.
deprecated: true
parameters:
- name: subnetID
required: true
in: path
description: alpha-numeric subnetID
schema:
type: string
- name: from
required: false
in: query
description: From date in UNIX Timestamp.
example: 1654819200
schema:
type: string
- name: to
required: false
in: query
description: To date in UNIX Timestamp.
example: 1655424000
schema:
type: string
- name: startKey
required: false
in: query
description: For paginated responses. Value will be provided in the [nextPageStartKey] field in the response if the query has more than one page.
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/SubnetMappingsResponse'
'400':
description: "Bad requests generally mean the client has passed invalid \n or malformed parameters. Error messages in the response could help in \n evaluating the error."
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequest'
'401':
description: "When a client attempts to access resources that require \n authorization credentials but the client lacks proper authentication \n in the request, the server responds with 401."
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
'403':
description: "When a client attempts to access resources with valid\n credentials but doesn't have the privilege to perform that action, \n the server responds with 403."
content:
application/json:
schema:
$ref: '#/components/schemas/Forbidden'
'404':
description: "The error is mostly returned when the client requests\n with either mistyped URL, or the passed resource is moved or deleted, \n or the resource doesn't exist."
content:
application/json:
schema:
$ref: '#/components/schemas/NotFound'
'429':
description: "This error is returned when the client has sent too many,\n and has hit the rate limit."
content:
application/json:
schema:
$ref: '#/components/schemas/TooManyRequests'
'500':
description: "The error is a generic server side error that is \n returned for any uncaught and unexpected issues on the server side. \n This should be very rare, and you may reach out to us if the problem \n persists for a longer duration."
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerError'
'502':
description: "This is an internal error indicating invalid response \n received by the client-facing proxy or gateway from the upstream server."
content:
application/json:
schema:
$ref: '#/components/schemas/BadGateway'
'503':
description: "The error is returned for certain routes on a particular\n Subnet. This indicates an internal problem with our Subnet node, and may \n not necessarily mean the Subnet is down or affected."
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceUnavailable'
tags:
- EVM Chains
/v1/chains/network/{network}:
get:
operationId: getChainInformationByNetwork
x-execution-weight: free
x-speakeasy-group: metrics.chains
x-speakeasy-pagination:
type: cursor
inputs:
- name: startKey
in: parameters
type: cursor
outputs:
nextCursor: $.nextPageStartKey
x-speakeasy-ignore: true
description: Get chain information by network.
deprecated: true
parameters:
- name: network
required: true
in: path
description: Network type
example: mainnet
schema:
$ref: '#/components/schemas/LegacyNetworks'
- name: from
required: false
in: query
description: From date in UNIX Timestamp.
example: 1654819200
schema:
type: string
- name: to
required: false
in: query
description: To date in UNIX Timestamp.
example: 1655424000
schema:
type: string
- name: startKey
required: false
in: query
description: For paginated responses. Value will be provided in the [nextPageStartKey] field in the response if the query has more than one page.
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/ChainInformationResponse'
'400':
description: "Bad requests generally mean the client has passed invalid \n or malformed parameters. Error messages in the response could help in \n evaluating the error."
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequest'
'401':
description: "When a client attempts to access resources that require \n authorization credentials but the client lacks proper authentication \n in the request, the server responds with 401."
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
'403':
description: "When a client attempts to access resources with valid\n credentials but doesn't have the privilege to perform that action, \n the server responds with 403."
content:
application/json:
schema:
$ref: '#/components/schemas/Forbidden'
'404':
description: "The error is mostly returned when the client requests\n with either mistyped URL, or the passed resource is moved or deleted, \n or the resource doesn't exist."
content:
application/json:
schema:
$ref: '#/components/schemas/NotFound'
'429':
description: "This error is returned when the client has sent too many,\n and has hit the rate limit."
content:
application/json:
schema:
$ref: '#/components/schemas/TooManyRequests'
'500':
description: "The error is a generic server side error that is \n returned for any uncaught and unexpected issues on the server side. \n This should be very rare, and you may reach out to us if the problem \n persists for a longer duration."
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerError'
'502':
description: "This is an internal error indicating invalid response \n received by the client-facing proxy or gateway from the upstream server."
content:
application/json:
schema:
$ref: '#/components/schemas/BadGateway'
'503':
description: "The error is returned for certain routes on a particular\n Subnet. This indicates an internal problem with our Subnet node, and may \n not necessarily mean the Subnet is down or affected."
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceUnavailable'
tags:
- EVM Chains
/v1/chains/network/{network}/subnetId/{subnetID}:
get:
operationId: getChainInformationByNetworkAndSubnetId
x-execution-weight: free
x-speakeasy-group: metrics.chains
x-speakeasy-pagination:
type: cursor
inputs:
- name: startKey
in: parameters
type: cursor
outputs:
nextCursor: $.nextPageStartKey
x-speakeasy-ignore: true
description: Get chain information by network and subnet ID.
deprecated: true
parameters:
- name: network
required: true
in: path
description: Network type
example: mainnet
schema:
$ref: '#/components/schemas/LegacyNetworks'
- name: subnetID
required: true
in: path
description: alpha-numeric subnetID
schema:
type: string
- name: from
required: false
in: query
description: From date in UNIX Timestamp.
example: 1654819200
schema:
type: string
- name: to
required: false
in: query
description: To date in UNIX Timestamp.
example: 1655424000
schema:
type: string
- name: startKey
required: false
in: query
description: For paginated responses. Value will be provided in the [nextPageStartKey] field in the response if the query has more than one page.
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/ChainInformationResponse'
'400':
description: "Bad requests generally mean the client has passed invalid \n or malformed parameters. Error messages in the response could help in \n evaluating the error."
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequest'
'401':
description: "When a client attempts to access resources that require \n authorization credentials but the client lacks proper authentication \n in the request, the server responds with 401."
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
'403':
description: "When a client attempts to access resources with valid\n credentials but doesn't have the privilege to perform that action, \n the server responds with 403."
content:
application/json:
schema:
$ref: '#/components/schemas/Forbidden'
'404':
description: "The error is mostly returned when the client requests\n with either mistyped URL, or the passed resource is moved or deleted, \n or the resource doesn't exist."
content:
application/json:
schema:
$ref: '#/components/schemas/NotFound'
'429':
description: "This error is returned when the client has sent too many,\n and has hit the rate limit."
content:
application/json:
schema:
$ref: '#/components/schemas/TooManyRequests'
'500':
description: "The error is a generic server side error that is \n returned for any uncaught and unexpected issues on the server side. \n This should be very rare, and you may reach out to us if the problem \n persists for a longer duration."
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerError'
'502':
description: "This is an internal error indicating invalid response \n received by the client-facing proxy or gateway from the upstream server."
content:
application/json:
schema:
$ref: '#/components/schemas/BadGateway'
'503':
description: "The error is returned for certain routes on a particular\n Subnet. This indicates an internal problem with our Subnet node, and may \n not necessarily mean the Subnet is down or affected."
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceUnavailable'
tags:
- EVM Chains
/v1/subnets/network/{network}:
get:
operationId: getSubnetInformationByNetwork
x-execution-weight: free
x-speakeasy-group: metrics.chains
x-speakeasy-pagination:
type: cursor
inputs:
- name: startKey
in: parameters
type: cursor
outputs:
nextCursor: $.nextPageStartKey
x-speakeasy-ignore: true
description: Get subnet information by network.
deprecated: true
parameters:
- name: network
required: true
in: path
description: Network type
example: mainnet
schema:
$ref: '#/components/schemas/LegacyNetworks'
- name: from
required: false
in: query
description: From date in UNIX Timestamp.
example: 1654819200
schema:
type: string
- name: to
required: false
in: query
description: To date in UNIX Timestamp.
example: 1655424000
schema:
type: string
- name: startKey
required: false
in: query
description: For paginated responses. Value will be provided in the [nextPageStartKey] field in the response if the query has more than one page.
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/SubnetsResponse'
'400':
description: "Bad requests generally mean the client has passed invalid \n or malformed parameters. Error messages in the response could help in \n evaluating the error."
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequest'
'401':
description: "When a client attempts to access resources that require \n authorization credentials but the client lacks proper authentication \n in the request, the server responds with 401."
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
'403':
description: "When a client attempts to access resources with valid\n credentials but doesn't have the privilege to perform that action, \n the server responds with 403."
content:
application/json:
schema:
$ref: '#/components/schemas/Forbidden'
'404':
description: "The error is mostly returned when the client requests\n with either mistyped URL, or the passed resource is moved or deleted, \n or the resource doesn't exist."
content:
application/json:
schema:
$ref: '#/components/schemas/NotFound'
'429':
description: "This error is returned when the client has sent too many,\n and has hit the rate limit."
content:
application/json:
schema:
$ref: '#/components/schemas/TooManyRequests'
'500':
description: "The error is a generic server side error that is \n returned for any uncaught and unexpected issues on the server side. \n This should be very rare, and you may reach out to us if the problem \n persists for a longer duration."
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerError'
'502':
description: "This is an internal error indicating invalid response \n received by the client-facing proxy or gateway from the upstream server."
content:
application/json:
schema:
$ref: '#/components/schemas/BadGateway'
'503':
description: "The error is returned for certain routes on a particular\n Subnet. This indicates an internal problem with our Subnet node, and may \n not necessarily mean the Subnet is down or affected."
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceUnavailable'
tags:
- EVM Chains
/v1/subnets/network/{network}/subnetId/{subnetID}:
get:
operationId: getSubnetInformationByNetworkAndSubnetId
x-execution-weight: free
x-speakeasy-group: metrics.chains
x-speakeasy-pagination:
type: cursor
inputs:
- name: startKey
in: parameters
type: cursor
outputs:
nextCursor: $.nextPageStartKey
x-speakeasy-ignore: true
description: Get subnet information by network and subnet ID.
deprecated: true
parameters:
- name: network
required: true
in: path
description: Network type
example: mainnet
schema:
$ref: '#/components/schemas/LegacyNetworks'
- name: subnetID
required: true
in: path
description: alpha-numeric subnetID
schema:
type: string
- name: from
required: false
in: query
description: From date in UNIX Timestamp.
example: 1654819200
schema:
type: string
- name: to
required: false
in: query
description: To date in UNIX Timestamp.
example: 1655424000
schema:
type: string
- name: startKey
required: false
in: query
description: For paginated responses. Value will be provided in the [nextPageStartKey] field in the response if the query has more than one page.
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/SubnetsResponse'
'400':
description: "Bad requests generally mean the client has passed invalid \n or malformed parameters. Error messages in the response could help in \n evaluating the error."
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequest'
'401':
description: "When a client attempts to access resources that require \n authorization credentials but the client lacks proper authentication \n in the request, the server responds with 401."
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
'403':
description: "When a client attempts to access resources with valid\n credentials but doesn't have the privilege to perform that action, \n the server responds with 403."
content:
application/json:
schema:
$ref: '#/components/schemas/Forbidden'
'404':
description: "The error is mostly returned when the client requests\n with either mistyped URL, or the passed resource is moved or deleted, \n or the resource doesn't exist."
content:
application/json:
schema:
$ref: '#/components/schemas/NotFound'
'429':
description: "This error is returned when the client has sent too many,\n and has hit the rate limit."
content:
application/json:
schema:
$ref: '#/components/schemas/TooManyRequests'
'500':
description: "The error is a generic server side error that is \n returned for any uncaught and unexpected issues on the server side. \n This should be very rare, and you may reach out to us if the problem \n persists for a longer duration."
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerError'
'502':
description: "This is an internal error indicating invalid response \n received by the client-facing proxy or gateway from the upstream server."
content:
application/json:
schema:
$ref: '#/components/schemas/BadGateway'
'503':
description: "The error is returned for certain routes on a particular\n Subnet. This indicates an internal problem with our Subnet node, and may \n not necessarily mean the Subnet is down or affected."
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceUnavailable'
tags:
- EVM Chains
components:
schemas:
NetworkType:
type: string
description: Network on which this blockchain or subnet is created on.
enum:
- mainnet
- testnet
BadRequest:
type: object
properties:
message:
description: The error message describing the reason for the exception
oneOf:
- type: string
- type: array
items:
type: string
statusCode:
type: number
description: The HTTP status code of the response
examples:
- 400
error:
type: string
description: The type of error
examples:
- Bad Request
required:
- message
- statusCode
- error
ListEvmBlocksResponse:
type: object
properties:
nextPageToken:
type: string
description: A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted or empty, there are no subsequent pages.
blocks:
type: array
items:
$ref: '#/components/schemas/EvmBlock'
required:
- blocks
EvmBlock:
type: object
properties:
chainId:
type: string
description: The EVM chain ID on which the block was created.
examples:
- '43114'
blockNumber:
type: string
description: The block number on the chain.
examples:
- '339'
blockTimestamp:
type: number
description: The block finality timestamp.
examples:
- 1648672486
blockHash:
type: string
description: The block hash identifier.
examples:
- '0x17533aeb5193378b9ff441d61728e7a2ebaf10f61fd5310759451627dfca2e7c'
txCount:
type: number
description: The number of evm transactions in the block.
baseFee:
type: string
description: The base gas fee for a transaction to be included in the block.
gasUsed:
type: string
description: The gas used for transactions in the block.
gasLimit:
type: string
description: The total gas limit set for transactions in the block.
gasCost:
type: string
parentHash:
type: string
description: The hash of the parent block.
feesSpent:
type: string
description: The amount of fees spent/burned for transactions in the block.
cumulativeTransactions:
type: string
description: The cumulative number of transactions for the chain including this block.
required:
- chainId
- blockNumber
- blockTimestamp
- blockHash
- txCount
- baseFee
- gasUsed
- gasLimit
- gasCost
- parentHash
- feesSpent
- cumulativeTransactions
BadGateway:
type: object
properties:
message:
description: The error message describing the reason for the exception
oneOf:
- type: string
- type: array
items:
type: string
statusCode:
type: number
description: The HTTP status code of the response
examples:
- 502
error:
type: string
description: The type of error
examples:
- Bad Gateway
required:
- message
- statusCode
- error
Unauthorized:
type: object
properties:
message:
description: The error message describing the reason for the exception
oneOf:
- type: string
- type: array
items:
type: string
statusCode:
type: number
description: The HTTP status code of the response
examples:
- 401
error:
type: string
description: The type of error
examples:
- Unauthorized
required:
- message
- statusCode
- error
ListNativeTransactionsResponse:
type: object
properties:
nextPageToken:
type: string
description: A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted or empty, there are no subsequent pages.
transactions:
type: array
items:
$ref: '#/components/schemas/NativeTransaction'
required:
- transactions
TransactionStatus:
type: string
enum:
- failed
- success
Method:
type: object
properties:
callType:
examples:
- CONTRACT_CALL
$ref: '#/components/schemas/TransactionMethodType'
methodHash:
type: string
description: The contract method hash identifier. The method hash is only set if the `callType` is `CONTRACT_CALL`.
examples:
- '0xa9059cbb'
methodName:
type: string
description: The contract method name including parameter types. If the `callType` is `NATIVE_TRANSFER` this is set to 'Native Transfer'. If the `callType` is `CONTRACT_CREATION` this is set to 'Contract Created'.
examples:
- transfer(address,uint256)
required:
- callType
- methodHash
ListChainsResponse:
type: object
properties:
chains:
type: array
items:
$ref: '#/components/schemas/ChainInfo'
required:
- chains
NetworkToken:
type: object
properties:
name:
type: string
description: The contract name.
examples:
- Wrapped AVAX
symbol:
type: string
description: The contract symbol.
examples:
- WAVAX
decimals:
type: number
description: The number of decimals the token uses. For example `6`, means to divide the token amount by `1000000` to get its user representation.
examples:
- 18
logoUri:
type: string
description: The logo uri for the address.
examples:
- https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg
description:
type: string
required:
- name
- symbol
- decimals
Forbidden:
type: object
properties:
message:
description: The error message describing the reason for the exception
oneOf:
- type: string
- type: array
items:
type: string
statusCode:
type: number
description: The HTTP status code of the response
examples:
- 403
error:
type: string
description: The type of error
examples:
- Forbidden
required:
- message
- statusCode
- error
SubnetInformation:
type: object
properties:
controlKeys:
type: array
items:
type: string
threshold:
type: number
subnetID:
type: string
timestamp:
type: number
validatorCount:
type: number
required:
- controlKeys
- threshold
- subnetID
- timestamp
- validatorCount
SubnetMappingsResponse:
type: object
properties:
nextPageStartKey:
type: string
lastRun:
type: number
examples:
- 1717757617
status:
type: number
examples:
- 200
results:
type: array
items:
$ref: '#/components/schemas/SubnetMapping'
required:
- status
- results
TooManyRequests:
type: object
properties:
message:
description: The error message describing the reason for the exception
oneOf:
- type: string
- type: array
items:
type: string
statusCode:
type: number
description: The HTTP status code of the response
examples:
- 429
error:
type: string
description: The type of error
examples:
- Too Many Requests
required:
- message
- statusCode
- error
TransactionMethodType:
type: string
description: The contract call type. NATIVE_TRANSFER indicates a transfer of the native token without any smart-contract interaction. CONTRACT_CALL indicates a smart-contract interaction. CONTRACT_CREATION indicates a smart-contract creation.
enum:
- NATIVE_TRANSFER
- CONTRACT_CALL
- CONTRACT_CREATION
UtilityAddresses:
type: object
properties:
multicall:
type: string
ChainStatus:
type: string
description: Status of chain nodes. Chain nodes can become temporarily `UNAVAILABLE` for several reasons, such as validator stake falling below threshold. If chain nodes are `UNAVAILABLE`, requests that rely on data from the chain nodes may return 503 errors.
enum:
- OK
- UNAVAILABLE
SubnetsResponse:
type: object
properties:
nextPageStartKey:
type: string
lastRun:
type: number
examples:
- 1717757617
status:
type: number
examples:
- 200
results:
type: array
items:
$ref: '#/components/schemas/SubnetInformation'
required:
- status
- results
VmName:
type: string
enum:
- EVM
- BITCOIN
- ETHEREUM
ListAddressChainsResponse:
type: object
properties:
indexedChains:
type: array
items:
$ref: '#/components/schemas/ChainInfo'
unindexedChains:
type: array
items:
type: string
Chain:
type: object
properties:
evmChainId:
type: number
examples:
- 43114
description: EVM ChainID for the blockchain.
chainName:
type: string
examples:
- c_chain
description: Blockchain alias for easy identification of blockchains.
blockchainId:
type: string
examples:
- 2q9e4r6Mu3U68nU1fYjgbR6JvwrRx36CohpAX5UQxse55x1Q5
description: Unique blockchain ID for this blockchain.
subnetId:
type: string
examples:
- 11111111111111111111111111111111LpoYY
description: Subnet ID this blockchain belongs to.
network:
examples:
- mainnet
$ref: '#/components/schemas/NetworkType'
required:
- evmChainId
- chainName
- blockchainId
- subnetId
- network
Network:
type: string
enum:
- mainnet
- fuji
- testnet
ChainInformationResponse:
type: object
properties:
nextPageStartKey:
type: string
lastRun:
type: number
examples:
- 1717757617
status:
type: number
examples:
- 200
results:
type: array
items:
$ref: '#/components/schemas/ChainInformation'
required:
- status
- results
RichAddress:
type: object
properties:
name:
type: string
description: The contract name.
examples:
- Wrapped AVAX
symbol:
type: string
description: The contract symbol.
examples:
- WAVAX
decimals:
type: number
description: The number of decimals the token uses. For example `6`, means to divide the token amount by `1000000` to get its user representation.
examples:
- 18
logoUri:
type: string
description: The logo uri for the address.
examples:
- https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg
address:
type: string
description: A wallet or contract address in mixed-case checksum encoding.
examples:
- '0x71C7656EC7ab88b098defB751B7401B5f6d8976F'
required:
- address
InternalServerError:
type: object
properties:
message:
description: The error message describing the reason for the exception
oneOf:
- type: string
- type: array
items:
type: string
statusCode:
type: number
description: The HTTP status code of the response
examples:
- 500
error:
type: string
description: The type of error
examples:
- Internal Server Error
required:
- message
- statusCode
- error
SubnetMapping:
type: object
properties:
chainID:
type: number
subnetID:
type: string
timestamp:
type: number
network:
type: string
required:
- chainID
- subnetID
- timestamp
- network
ListChainsResponse_2:
type: object
properties:
nextPageToken:
type: string
description: A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted or empty, there are no subsequent pages.
chains:
description: Array of Subnet - EVM Chain ID mappings whose metrics we support.
type: array
items:
$ref: '#/components/schemas/Chain'
required:
- chains
ServiceUnavailable:
type: object
properties:
message:
description: The error message describing the reason for the exception
oneOf:
- type: string
- type: array
items:
type: string
statusCode:
type: number
description: The HTTP status code of the response
examples:
- 503
error:
type: string
description: The type of error
examples:
- Service Unavailable
required:
- message
- statusCode
- error
ChainInformation:
type: object
properties:
subnetID:
type: string
timestamp:
type: number
blockchainID:
type: string
vmID:
type: string
chainName:
type: string
required:
- subnetID
- timestamp
- blockchainID
- vmID
- chainName
NotFound:
type: object
properties:
message:
description: The error message describing the reason for the exception
oneOf:
- type: string
- type: array
items:
type: string
statusCode:
type: number
description: The HTTP status code of the response
examples:
- 404
error:
type: string
description: The type of error
examples:
- Not Found
required:
- message
- statusCode
- error
ApiFeature:
type: string
enum:
- nftIndexing
- webhooks
- teleporter
LegacyNetworks:
type: string
enum:
- mainnet
- fuji
NativeTransaction:
type: object
properties:
blockNumber:
type: string
description: The block number on the chain.
examples:
- '339'
blockTimestamp:
type: number
description: The block finality timestamp.
examples:
- 1648672486
blockHash:
type: string
description: The block hash identifier.
examples:
- '0x17533aeb5193378b9ff441d61728e7a2ebaf10f61fd5310759451627dfca2e7c'
chainId:
type: string
description: The EVM chain ID on which the transaction occured.
examples:
- '43114'
blockIndex:
type: number
description: The index at which the transaction occured in the block (0-indexed).
examples:
- 0
txHash:
type: string
description: The transaction hash identifier.
examples:
- '0x3e9303f81be00b4af28515dab7b914bf3dbff209ea10e7071fa24d4af0a112d4'
txStatus:
type: string
description: The transaction status, which is either 0 (failed) or 1 (successful).
examples:
- '1'
txType:
type: number
description: The transaction type.
examples:
- 1
gasLimit:
type: string
description: The gas limit set for the transaction.
examples:
- '51373'
gasUsed:
type: string
description: The amount of gas used.
examples:
- '51373'
gasPrice:
type: string
description: The gas price denominated by the number of decimals of the native token.
examples:
- '470000000000'
nonce:
type: string
description: The nonce used by the sender of the transaction.
examples:
- '1'
from:
$ref: '#/components/schemas/RichAddress'
to:
$ref: '#/components/schemas/RichAddress'
method:
$ref: '#/components/schemas/Method'
value:
type: string
examples:
- '10000000000000000000'
required:
- blockNumber
- blockTimestamp
- blockHash
- chainId
- blockIndex
- txHash
- txStatus
- txType
- gasLimit
- gasUsed
- gasPrice
- nonce
- from
- to
- value
ChainInfo:
type: object
properties:
chainId:
type: string
status:
$ref: '#/components/schemas/ChainStatus'
chainName:
type: string
description:
type: string
platformChainId:
type: string
subnetId:
type: string
vmId:
type: string
vmName:
$ref: '#/components/schemas/VmName'
explorerUrl:
type: string
rpcUrl:
type: string
wsUrl:
type: string
isTestnet:
type: boolean
utilityAddresses:
$ref: '#/components/schemas/UtilityAddresses'
networkToken:
$ref: '#/components/schemas/NetworkToken'
chainLogoUri:
type: string
private:
type: boolean
enabledFeatures:
type: array
items:
type: string
enum:
- nftIndexing
- webhooks
- teleporter
required:
- chainId
- status
- chainName
- description
- vmName
- rpcUrl
- isTestnet
- networkToken
GetChainResponse:
type: object
properties:
chainId:
type: string
status:
$ref: '#/components/schemas/ChainStatus'
chainName:
type: string
description:
type: string
platformChainId:
type: string
subnetId:
type: string
vmId:
type: string
vmName:
$ref: '#/components/schemas/VmName'
explorerUrl:
type: string
rpcUrl:
type: string
wsUrl:
type: string
isTestnet:
type: boolean
utilityAddresses:
$ref: '#/components/schemas/UtilityAddresses'
networkToken:
$ref: '#/components/schemas/NetworkToken'
chainLogoUri:
type: string
private:
type: boolean
enabledFeatures:
type: array
items:
type: string
enum:
- nftIndexing
- webhooks
- teleporter
required:
- chainId
- status
- chainName
- description
- vmName
- rpcUrl
- isTestnet
- networkToken
securitySchemes:
apiKey:
type: apiKey
in: header
name: x-glacier-api-key
description: Api keys provide higher access to rate limits. To obtain an api key, sign up for an account at https://avacloud.io/.
x-speakeasy-retries:
strategy: backoff
backoff:
initialInterval: 500
maxInterval: 60000
maxElapsedTime: 120000
exponent: 1.5
statusCodes:
- 5XX
retryConnectionErrors: true
x-speakeasy-globals:
parameters:
- $ref: '#/components/parameters/GlobalParamChainId'
- $ref: '#/components/parameters/GlobalParamNetwork'
x-execution-weight-values:
free: 1
large: 50
medium: 20
none: 0
small: 10
xl: 100
xxl: 200
x-rpc-method-execution-weights:
eth_accounts: free
eth_blockNumber: small
eth_call: small
eth_coinbase: small
eth_chainId: free
eth_gasPrice: small
eth_getBalance: small
eth_getBlockByHash: small
eth_getBlockByNumber: small
eth_getBlockTransactionCountByNumber: medium
eth_getCode: medium
eth_getLogs: xxl
eth_getStorageAt: medium
eth_getTransactionByBlockNumberAndIndex: medium
eth_getTransactionByHash: small
eth_getTransactionCount: small
eth_getTransactionReceipt: small
eth_signTransaction: medium
eth_sendTransaction: medium
eth_sign: medium
eth_sendRawTransaction: small
eth_syncing: free
net_listening: free
net_peerCount: medium
net_version: free
web3_clientVersion: small
web3_sha3: small
eth_newPendingTransactionFilter: medium
eth_maxPriorityFeePerGas: small
eth_baseFee: small
rpc_modules: free
eth_getChainConfig: small
eth_feeConfig: small
eth_getActivePrecompilesAt: small
x-speakeasy-webhooks:
security:
type: signature
headerName: x-signature
signatureTextEncoding: base64
algorithm: hmac-sha256