openapi: 3.1.0
info:
title: Data AVAX Supply EVM Transactions 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://data-api.avax.network
security:
- apiKey: []
- {}
tags:
- name: EVM Transactions
description: Find information about transactions on EVM-compatible chains, such as the Avalanche C-Chain.
paths:
/v1/transactions:
get:
operationId: listLatestTransactionsAllChains
x-speakeasy-group: data.evm.transactions
x-speakeasy-name-override: listLatestAllChains
x-speakeasy-pagination:
type: cursor
inputs:
- name: pageToken
in: parameters
type: cursor
outputs:
nextCursor: $.nextPageToken
summary: List the latest transactions across all supported EVM chains
description: Lists the most recent transactions from all supported EVM-compatible chains. The results can be filtered based on transaction status.
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 Transactions
/v1/chains/{chainId}/contracts/{address}/transactions:getDeployment:
get:
operationId: getDeploymentTransaction
x-speakeasy-group: data.evm.contracts
x-execution-weight: medium
summary: Get deployment transaction
description: If the address is a smart contract, returns the transaction in which it was deployed.
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
- name: address
required: true
in: path
description: Contract address on the relevant chain.
example: '0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E'
schema:
type: string
- name: currency
required: false
in: query
description: The currency that return values should use. Defaults to USD.
example: usd
schema:
$ref: '#/components/schemas/CurrencyCode'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/GetTransactionResponse'
'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 Transactions
/v1/chains/{chainId}/contracts/{address}/deployments:
get:
operationId: listContractDeployments
x-speakeasy-group: data.evm.address.contracts
x-speakeasy-name-override: listDeployments
x-speakeasy-pagination:
type: cursor
inputs:
- name: pageToken
in: parameters
type: cursor
outputs:
nextCursor: $.nextPageToken
x-execution-weight: medium
summary: List deployed contracts
description: Lists all contracts deployed by the given address.
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: 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
- 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/ListContractsResponse'
'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 Transactions
/v1/chains/{chainId}/tokens/{address}/transfers:
get:
operationId: listTransfers
x-speakeasy-group: data.evm.contracts
x-speakeasy-pagination:
type: cursor
inputs:
- name: pageToken
in: parameters
type: cursor
outputs:
nextCursor: $.nextPageToken
x-execution-weight: medium
summary: List ERC transfers
description: Lists ERC transfers for an ERC-20, ERC-721, or ERC-1155 contract address.
parameters:
- name: startBlock
required: false
in: query
description: The block range start number, inclusive. If endBlock is not defined when startBlock is defined, the end of the range will be the most recent block.
example: '6479329'
schema:
type: number
- name: endBlock
required: false
in: query
description: The block range end number, exclusive. If startBlock is not defined when endBlock is defined, the start of the range will be the genesis block.
example: '6479330'
schema:
type: number
- 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: 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
- 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/ListTransfersResponse'
'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 Transactions
/v1/chains/{chainId}/addresses/{address}/transactions:
get:
operationId: listTransactions
x-speakeasy-group: data.evm.address.transactions
x-speakeasy-name-override: list
x-speakeasy-pagination:
type: cursor
inputs:
- name: pageToken
in: parameters
type: cursor
outputs:
nextCursor: $.nextPageToken
x-execution-weight: medium
summary: List transactions
description: 'Returns a list of transactions where the given wallet address had an on-chain interaction for the given chain. The ERC-20 transfers, ERC-721 transfers, ERC-1155, and internal transactions returned are only those where the input address had an interaction. Specifically, those lists only inlcude entries where the input address was the sender (`from` field) or the receiver (`to` field) for the sub-transaction. Therefore the transactions returned from this list may not be complete representations of the on-chain data. For a complete view of a transaction use the `/chains/:chainId/transactions/:txHash` endpoint.
Filterable by block ranges.'
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: startBlock
required: false
in: query
description: The block range start number, inclusive. If endBlock is not defined when startBlock is defined, the end of the range will be the most recent block.
example: '6479329'
schema:
type: number
- name: endBlock
required: false
in: query
description: The block range end number, exclusive. If startBlock is not defined when endBlock is defined, the start of the range will be the genesis block.
example: '6479330'
schema:
type: number
- 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
- name: address
required: true
in: path
description: A wallet address.
example: '0x71C7656EC7ab88b098defB751B7401B5f6d8976F'
schema:
type: string
- name: sortOrder
required: false
in: query
example: asc
description: The order by which to sort results. Use "asc" for ascending order, "desc" for descending order. Sorted by timestamp or the `sortBy` query parameter, if provided.
schema:
$ref: '#/components/schemas/SortOrder'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/ListTransactionDetailsResponse'
'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 Transactions
/v2/chains/{chainId}/addresses/{address}/transactions:
get:
operationId: listTransactionsV2
x-speakeasy-group: data.evm.address.transactions
x-speakeasy-name-override: list
x-speakeasy-pagination:
type: cursor
inputs:
- name: pageToken
in: parameters
type: cursor
outputs:
nextCursor: $.nextPageToken
x-execution-weight: medium
summary: List transactions v2
description: 'Returns a list of transactions where the given wallet address had an on-chain interaction for the given chain. The ERC-20 transfers (with token reputation), ERC-721 transfers, ERC-1155, and internal transactions returned are only those where the input address had an interaction. Specifically, those lists only inlcude entries where the input address was the sender (`from` field) or the receiver (`to` field) for the sub-transaction. Therefore the transactions returned from this list may not be complete representations of the on-chain data. For a complete view of a transaction use the `/chains/:chainId/transactions/:txHash` endpoint.
Filterable by block ranges.'
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: startBlock
required: false
in: query
description: The block range start number, inclusive. If endBlock is not defined when startBlock is defined, the end of the range will be the most recent block.
example: '6479329'
schema:
type: number
- name: endBlock
required: false
in: query
description: The block range end number, exclusive. If startBlock is not defined when endBlock is defined, the start of the range will be the genesis block.
example: '6479330'
schema:
type: number
- name: filterSpamTokens
required: false
in: query
schema:
type: boolean
- 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
- name: address
required: true
in: path
description: A wallet address.
example: '0x71C7656EC7ab88b098defB751B7401B5f6d8976F'
schema:
type: string
- name: sortOrder
required: false
in: query
example: asc
description: The order by which to sort results. Use "asc" for ascending order, "desc" for descending order. Sorted by timestamp or the `sortBy` query parameter, if provided.
schema:
$ref: '#/components/schemas/SortOrder'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/ListTransactionDetailsResponseV2'
'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 Transactions
/v1/chains/{chainId}/addresses/{address}/transactions:listNative:
get:
operationId: listNativeTransactions
x-speakeasy-group: data.evm.address.transactions
x-speakeasy-name-override: listNative
x-speakeasy-pagination:
type: cursor
inputs:
- name: pageToken
in: parameters
type: cursor
outputs:
nextCursor: $.nextPageToken
x-execution-weight: medium
summary: List native transactions
description: Lists native transactions for an address. Filterable by block range.
parameters:
- name: startBlock
required: false
in: query
description: The block range start number, inclusive. If endBlock is not defined when startBlock is defined, the end of the range will be the most recent block.
example: '6479329'
schema:
type: number
- name: endBlock
required: false
in: query
description: The block range end number, exclusive. If startBlock is not defined when endBlock is defined, the start of the range will be the genesis block.
example: '6479330'
schema:
type: number
- 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: 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
- 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/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 Transactions
/v1/chains/{chainId}/addresses/{address}/transactions:listErc20:
get:
operationId: listErc20Transactions
x-speakeasy-group: data.evm.address.transactions
x-speakeasy-name-override: listErc20
x-speakeasy-pagination:
type: cursor
inputs:
- name: pageToken
in: parameters
type: cursor
outputs:
nextCursor: $.nextPageToken
x-execution-weight: medium
summary: List ERC-20 transfers
description: Lists ERC-20 transfers for an address. Filterable by block range.
parameters:
- name: startBlock
required: false
in: query
description: The block range start number, inclusive. If endBlock is not defined when startBlock is defined, the end of the range will be the most recent block.
example: '6479329'
schema:
type: number
- name: endBlock
required: false
in: query
description: The block range end number, exclusive. If startBlock is not defined when endBlock is defined, the start of the range will be the genesis block.
example: '6479330'
schema:
type: number
- 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: 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
- 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/ListErc20TransactionsResponse'
'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 Transactions
/v1/chains/{chainId}/addresses/{address}/transactions:listErc721:
get:
operationId: listErc721Transactions
x-speakeasy-group: data.evm.address.transactions
x-speakeasy-name-override: listErc721
x-speakeasy-pagination:
type: cursor
inputs:
- name: pageToken
in: parameters
type: cursor
outputs:
nextCursor: $.nextPageToken
x-execution-weight: medium
summary: List ERC-721 transfers
description: Lists ERC-721 transfers for an address. Filterable by block range.
parameters:
- name: startBlock
required: false
in: query
description: The block range start number, inclusive. If endBlock is not defined when startBlock is defined, the end of the range will be the most recent block.
example: '6479329'
schema:
type: number
- name: endBlock
required: false
in: query
description: The block range end number, exclusive. If startBlock is not defined when endBlock is defined, the start of the range will be the genesis block.
example: '6479330'
schema:
type: number
- 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: 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
- 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/ListErc721TransactionsResponse'
'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 Transactions
/v1/chains/{chainId}/addresses/{address}/transactions:listErc1155:
get:
operationId: listErc1155Transactions
x-speakeasy-group: data.evm.address.transactions
x-speakeasy-name-override: listErc1155
x-speakeasy-pagination:
type: cursor
inputs:
- name: pageToken
in: parameters
type: cursor
outputs:
nextCursor: $.nextPageToken
x-execution-weight: medium
summary: List ERC-1155 transfers
description: Lists ERC-1155 transfers for an address. Filterable by block range.
parameters:
- name: startBlock
required: false
in: query
description: The block range start number, inclusive. If endBlock is not defined when startBlock is defined, the end of the range will be the most recent block.
example: '6479329'
schema:
type: number
- name: endBlock
required: false
in: query
description: The block range end number, exclusive. If startBlock is not defined when endBlock is defined, the start of the range will be the genesis block.
example: '6479330'
schema:
type: number
- 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: 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
- 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/ListErc1155TransactionsResponse'
'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 Transactions
/v1/chains/{chainId}/addresses/{address}/transactions:listInternals:
get:
operationId: listInternalTransactions
x-speakeasy-group: data.evm.address.transactions
x-speakeasy-name-override: listInternal
x-speakeasy-pagination:
type: cursor
inputs:
- name: pageToken
in: parameters
type: cursor
outputs:
nextCursor: $.nextPageToken
x-execution-weight: medium
summary: List internal transactions
description: 'Returns a list of internal transactions for an address and chain. Filterable by block range.
Note that the internal transactions list only contains `CALL` or `CALLCODE` transactions with a non-zero value and `CREATE`/`CREATE2`/`CREATE3` transactions. To get a complete list of internal transactions use the `debug_` prefixed RPC methods on an archive node.'
parameters:
- name: startBlock
required: false
in: query
description: The block range start number, inclusive. If endBlock is not defined when startBlock is defined, the end of the range will be the most recent block.
example: '6479329'
schema:
type: number
- name: endBlock
required: false
in: query
description: The block range end number, exclusive. If startBlock is not defined when endBlock is defined, the start of the range will be the genesis block.
example: '6479330'
schema:
type: number
- 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: 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
- 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/ListInternalTransactionsResponse'
'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 Transactions
/v1/chains/{chainId}/transactions/{txHash}:
get:
operationId: getTransaction
x-speakeasy-group: data.evm.transactions
x-speakeasy-name-override: get
x-execution-weight: medium
summary: Get transaction
description: Gets the details of a single transaction.
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
- name: txHash
required: true
in: path
description: A transaction hash.
example: '0x8bf584d7b14b92a32a339872a66b134a70ba3ba7c305823f348db6f860253f45'
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/GetTransactionResponse'
'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 Transactions
/v1/chains/{chainId}/blocks/{blockId}/transactions:
get:
operationId: getTransactionsForBlock
x-speakeasy-group: data.evm.blocks
x-speakeasy-name-override: listTransactions
x-execution-weight: medium
summary: List transactions for a block
description: Lists the transactions that occured in a given block.
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 0. The maximum pageSize is 100.
schema:
type: integer
default: 0
minimum: 0
maximum: 100
example: '10'
- 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
- name: blockId
required: true
in: path
description: A block identifier which is either a block number or the block hash.
example: '0x17533aeb5193378b9ff441d61728e7a2ebaf10f61fd5310759451627dfca2e7c'
schema:
type: string
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 Transactions
/v1/chains/{chainId}/transactions:
get:
operationId: listLatestTransactions
x-speakeasy-group: data.evm.transactions
x-speakeasy-name-override: listLatest
x-speakeasy-pagination:
type: cursor
inputs:
- name: pageToken
in: parameters
type: cursor
outputs:
nextCursor: $.nextPageToken
x-execution-weight: medium
summary: List latest transactions
description: Lists the latest transactions. Filterable by status.
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: 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
- 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 Transactions
components:
schemas:
Erc20Contract:
type: object
properties:
name:
type: string
description: The contract name.
examples:
- Wrapped AVAX
description:
type: string
officialSite:
type: string
email:
type: string
logoAsset:
$ref: '#/components/schemas/ImageAsset'
bannerAsset:
$ref: '#/components/schemas/ImageAsset'
color:
type: string
resourceLinks:
type: array
items:
$ref: '#/components/schemas/ResourceLink'
tags:
type: array
items:
type: string
address:
type: string
description: A wallet or contract address in mixed-case checksum encoding.
examples:
- '0x71C7656EC7ab88b098defB751B7401B5f6d8976F'
deploymentDetails:
$ref: '#/components/schemas/ContractDeploymentDetails'
ercType:
type: string
enum:
- ERC-20
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
pricingProviders:
$ref: '#/components/schemas/PricingProviders'
required:
- address
- ercType
- decimals
ListTransactionDetailsResponseV2:
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/TransactionDetailsV2'
required:
- transactions
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
Erc1155TransferDetails:
type: object
properties:
from:
$ref: '#/components/schemas/RichAddress'
to:
$ref: '#/components/schemas/RichAddress'
logIndex:
type: number
value:
type: string
examples:
- '10000000000000000000'
erc1155Token:
$ref: '#/components/schemas/Erc1155Token'
required:
- from
- to
- logIndex
- value
- erc1155Token
CurrencyCode:
type: string
description: ISO 4217 currency code.
enum:
- usd
- eur
- aud
- cad
- chf
- clp
- cny
- czk
- dkk
- gbp
- hkd
- huf
- jpy
- nzd
TransactionStatus:
type: string
enum:
- failed
- success
GetTransactionResponse:
type: object
properties:
erc20Transfers:
description: The list of ERC-20 transfers.
type: array
items:
$ref: '#/components/schemas/Erc20TransferDetails'
erc721Transfers:
description: The list of ERC-721 transfers.
type: array
items:
$ref: '#/components/schemas/Erc721TransferDetails'
erc1155Transfers:
description: The list of ERC-1155 transfers.
type: array
items:
$ref: '#/components/schemas/Erc1155TransferDetails'
internalTransactions:
description: The list of internal transactions. Note that this list only includes CALL and CALLCODE internal transactions that had a non-zero value and CREATE/CREATE2/CREATE3 calls. Use a client provider to recieve a full debug trace of the transaction.
type: array
items:
$ref: '#/components/schemas/InternalTransactionDetails'
networkTokenDetails:
$ref: '#/components/schemas/NetworkTokenDetails'
nativeTransaction:
$ref: '#/components/schemas/FullNativeTransactionDetails'
teleporterMessageInfo:
description: Corresponding teleporter message info if available.
allOf:
- $ref: '#/components/schemas/TeleporterMessageInfo'
required:
- networkTokenDetails
- nativeTransaction
ListContractsResponse:
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.
contracts:
type: array
items:
oneOf:
- $ref: '#/components/schemas/Erc721Contract'
- $ref: '#/components/schemas/Erc1155Contract'
- $ref: '#/components/schemas/Erc20Contract'
- $ref: '#/components/schemas/UnknownContract'
discriminator:
propertyName: ercType
mapping:
ERC-721: '#/components/schemas/Erc721Contract'
ERC-1155: '#/components/schemas/Erc1155Contract'
ERC-20: '#/components/schemas/Erc20Contract'
UNKNOWN: '#/components/schemas/UnknownContract'
required:
- contracts
Money:
type: object
properties:
currencyCode:
examples:
- usd
$ref: '#/components/schemas/CurrencyCode'
value:
type: number
description: Monetary value in base 10 decimals.
examples:
- '42.42'
required:
- currencyCode
- value
Erc721Token:
type: object
properties:
address:
type: string
description: A wallet or contract address in mixed-case checksum encoding.
examples:
- '0x71C7656EC7ab88b098defB751B7401B5f6d8976F'
name:
type: string
description: The contract name.
examples:
- Wrapped AVAX
symbol:
type: string
description: The contract symbol.
examples:
- WAVAX
ercType:
type: string
enum:
- ERC-721
tokenId:
type: string
tokenUri:
type: string
metadata:
$ref: '#/components/schemas/Erc721TokenMetadata'
ownerAddress:
type: string
description: A wallet or contract address in mixed-case checksum encoding.
examples:
- '0x71C7656EC7ab88b098defB751B7401B5f6d8976F'
required:
- address
- name
- symbol
- ercType
- tokenId
- tokenUri
- metadata
Erc20TransferDetails:
type: object
properties:
from:
$ref: '#/components/schemas/RichAddress'
to:
$ref: '#/components/schemas/RichAddress'
logIndex:
type: number
value:
type: string
examples:
- '10000000000000000000'
erc20Token:
$ref: '#/components/schemas/Erc20Token'
required:
- from
- to
- logIndex
- value
- erc20Token
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
Erc1155TokenMetadata:
type: object
properties:
indexStatus:
examples:
- indexed
$ref: '#/components/schemas/NftTokenMetadataStatus'
metadataLastUpdatedTimestamp:
type: number
name:
type: string
symbol:
type: string
imageUri:
type: string
description:
type: string
animationUri:
type: string
externalUrl:
type: string
background:
type: string
decimals:
type: number
properties:
type: string
required:
- indexStatus
UnknownContract:
type: object
properties:
name:
type: string
description: The contract name.
examples:
- Wrapped AVAX
description:
type: string
officialSite:
type: string
email:
type: string
logoAsset:
$ref: '#/components/schemas/ImageAsset'
bannerAsset:
$ref: '#/components/schemas/ImageAsset'
color:
type: string
resourceLinks:
type: array
items:
$ref: '#/components/schemas/ResourceLink'
tags:
type: array
items:
type: string
address:
type: string
description: A wallet or contract address in mixed-case checksum encoding.
examples:
- '0x71C7656EC7ab88b098defB751B7401B5f6d8976F'
deploymentDetails:
$ref: '#/components/schemas/ContractDeploymentDetails'
ercType:
type: string
enum:
- UNKNOWN
required:
- address
- ercType
SortOrder:
type: string
enum:
- asc
- desc
TransactionDetailsV2:
type: object
properties:
nativeTransaction:
description: The native (top-level) transaction details.
allOf:
- $ref: '#/components/schemas/NativeTransaction'
erc20Transfers:
description: The list of ERC-20 transfers.
type: array
items:
$ref: '#/components/schemas/Erc20TransferDetailsV2'
erc721Transfers:
description: The list of ERC-721 transfers.
type: array
items:
$ref: '#/components/schemas/Erc721TransferDetails'
erc1155Transfers:
description: The list of ERC-1155 transfers.
type: array
items:
$ref: '#/components/schemas/Erc1155TransferDetails'
internalTransactions:
description: The list of internal transactions. Note that this list only includes CALL and CALLCODE internal transactions that had a non-zero value and CREATE/CREATE2/CREATE3 calls. Use a client provider to recieve a full debug trace of the transaction.
type: array
items:
$ref: '#/components/schemas/InternalTransactionDetails'
required:
- nativeTransaction
ListTransactionDetailsResponse:
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/TransactionDetails'
required:
- transactions
Erc721TokenMetadata:
type: object
properties:
indexStatus:
examples:
- indexed
$ref: '#/components/schemas/NftTokenMetadataStatus'
metadataLastUpdatedTimestamp:
type: number
name:
type: string
symbol:
type: string
imageUri:
type: string
description:
type: string
animationUri:
type: string
externalUrl:
type: string
background:
type: string
attributes:
type: string
required:
- indexStatus
ListErc1155TransactionsResponse:
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/Erc1155Transfer'
required:
- transactions
FullNativeTransactionDetails:
type: object
properties:
blockNumber:
type: string
description: The block number on the chain.
examples:
- '339'
blockTimestamp:
type: number
description: The block creation (proposal) timestamp in seconds
examples:
- 1648672486
blockTimestampMilliseconds:
type: number
description: The block creation (proposal) timestamp in milliseconds. Available only after Granite upgrade.
examples:
- 1648672486000
blockMinDelayExcess:
type: number
description: Minimum block delay in milliseconds. Available only after Granite upgrade.
examples:
- 7477290
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'
input:
type: string
description: The data sent for the transaction.
baseFeePerGas:
type: string
maxFeePerGas:
type: string
maxPriorityFeePerGas:
type: string
required:
- blockNumber
- blockTimestamp
- blockHash
- chainId
- blockIndex
- txHash
- txStatus
- txType
- gasLimit
- gasUsed
- gasPrice
- nonce
- from
- to
- value
- input
- baseFeePerGas
TransactionDirectionType:
type: string
enum:
- SOURCE_TRANSACTION
- DESTINATION_TRANSACTION
InternalTransactionDetails:
type: object
properties:
from:
$ref: '#/components/schemas/RichAddress'
to:
$ref: '#/components/schemas/RichAddress'
internalTxType:
$ref: '#/components/schemas/InternalTransactionOpCall'
value:
type: string
examples:
- '10000000000000000000'
isReverted:
type: boolean
description: True if the internal transaction was reverted.
gasUsed:
type: string
gasLimit:
type: string
required:
- from
- to
- internalTxType
- value
- isReverted
- gasUsed
- gasLimit
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
ListErc20TransactionsResponse:
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/Erc20Transfer'
required:
- transactions
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
Erc1155Contract:
type: object
properties:
name:
type: string
description: The contract name.
examples:
- Wrapped AVAX
description:
type: string
officialSite:
type: string
email:
type: string
logoAsset:
$ref: '#/components/schemas/ImageAsset'
bannerAsset:
$ref: '#/components/schemas/ImageAsset'
color:
type: string
resourceLinks:
type: array
items:
$ref: '#/components/schemas/ResourceLink'
tags:
type: array
items:
type: string
address:
type: string
description: A wallet or contract address in mixed-case checksum encoding.
examples:
- '0x71C7656EC7ab88b098defB751B7401B5f6d8976F'
deploymentDetails:
$ref: '#/components/schemas/ContractDeploymentDetails'
ercType:
type: string
enum:
- ERC-1155
symbol:
type: string
description: The contract symbol.
examples:
- WAVAX
pricingProviders:
$ref: '#/components/schemas/PricingProviders'
required:
- address
- ercType
Erc721TransferDetails:
type: object
properties:
from:
$ref: '#/components/schemas/RichAddress'
to:
$ref: '#/components/schemas/RichAddress'
logIndex:
type: number
erc721Token:
$ref: '#/components/schemas/Erc721Token'
required:
- from
- to
- logIndex
- erc721Token
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
NftTokenMetadataStatus:
type: string
description: The metadata indexing status of the nft.
enum:
- UNKNOWN
- MISSING_TOKEN
- INVALID_TOKEN_URI
- INVALID_TOKEN_URI_SCHEME
- UNREACHABLE_TOKEN_URI
- THROTTLED_TOKEN_URI
- METADATA_CONTENT_TOO_LARGE
- INVALID_METADATA
- INVALID_METADATA_JSON
- INDEXED
- UNINDEXED
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
Erc1155Transfer:
type: object
properties:
blockNumber:
type: string
description: The block number on the chain.
examples:
- '339'
blockTimestamp:
type: number
description: The block creation (proposal) timestamp in seconds
examples:
- 1648672486
blockTimestampMilliseconds:
type: number
description: The block creation (proposal) timestamp in milliseconds. Available only after Granite upgrade.
examples:
- 1648672486000
blockHash:
type: string
description: The block hash identifier.
examples:
- '0x17533aeb5193378b9ff441d61728e7a2ebaf10f61fd5310759451627dfca2e7c'
txHash:
type: string
description: The transaction hash identifier.
examples:
- '0x3e9303f81be00b4af28515dab7b914bf3dbff209ea10e7071fa24d4af0a112d4'
from:
$ref: '#/components/schemas/RichAddress'
to:
$ref: '#/components/schemas/RichAddress'
logIndex:
type: number
value:
type: string
examples:
- '10000000000000000000'
erc1155Token:
$ref: '#/components/schemas/Erc1155Token'
required:
- blockNumber
- blockTimestamp
- blockHash
- txHash
- from
- to
- logIndex
- value
- erc1155Token
ListTransfersResponse:
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.
transfers:
type: array
items:
oneOf:
- $ref: '#/components/schemas/Erc20Transfer'
- $ref: '#/components/schemas/Erc721Transfer'
- $ref: '#/components/schemas/Erc1155Transfer'
required:
- transfers
TransactionDetails:
type: object
properties:
nativeTransaction:
description: The native (top-level) transaction details.
allOf:
- $ref: '#/components/schemas/NativeTransaction'
erc20Transfers:
description: The list of ERC-20 transfers.
type: array
items:
$ref: '#/components/schemas/Erc20TransferDetails'
erc721Transfers:
description: The list of ERC-721 transfers.
type: array
items:
$ref: '#/components/schemas/Erc721TransferDetails'
erc1155Transfers:
description: The list of ERC-1155 transfers.
type: array
items:
$ref: '#/components/schemas/Erc1155TransferDetails'
internalTransactions:
description: The list of internal transactions. Note that this list only includes CALL and CALLCODE internal transactions that had a non-zero value and CREATE/CREATE2/CREATE3 calls. Use a client provider to recieve a full debug trace of the transaction.
type: array
items:
$ref: '#/components/schemas/InternalTransactionDetails'
required:
- nativeTransaction
NetworkTokenDetails:
type: object
properties:
networkToken:
$ref: '#/components/schemas/NetworkToken'
currentPrice:
description: The current token price, if available.
allOf:
- $ref: '#/components/schemas/Money'
historicalPrice:
description: The historical token price at the time the transaction occured, if available. Note, this is only provided if the transaction occured more than 24 hours ago.
allOf:
- $ref: '#/components/schemas/Money'
required:
- networkToken
ListErc721TransactionsResponse:
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/Erc721Transfer'
required:
- transactions
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
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
ListInternalTransactionsResponse:
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/InternalTransaction'
required:
- transactions
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
Erc20TokenV2:
type: object
properties:
address:
type: string
description: A wallet or contract address in mixed-case checksum encoding.
examples:
- '0x71C7656EC7ab88b098defB751B7401B5f6d8976F'
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
ercType:
type: string
enum:
- ERC-20
price:
description: The token price, if available.
allOf:
- $ref: '#/components/schemas/Money'
tokenReputation:
type:
- string
- 'null'
enum:
- Malicious
- Benign
description: Indicates the reputation of the token based on a security analysis. 'Benign' suggests the token is likely safe, while 'Malicious' indicates potential security risks. This field is nullable and is only populated for tokens on the C-Chain. Possible values are 'Benign', 'Malicious', or null if the reputation is unknown.
examples:
- Malicious
- Benign
- null
required:
- address
- name
- symbol
- decimals
- ercType
- tokenReputation
ResourceLinkType:
type: string
enum:
- Blog
- CoinGecko
- CoinMarketCap
- Discord
- Documentation
- Facebook
- Github
- Instagram
- LinkedIn
- Medium
- Reddit
- Support
- Telegram
- TikTok
- Twitter
- Website
- Whitepaper
- Youtube
PricingProviders:
type: object
properties:
coingeckoCoinId:
type: string
ResourceLink:
type: object
properties:
type:
$ref: '#/components/schemas/ResourceLinkType'
url:
type: string
required:
- type
- url
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
InternalTransactionOpCall:
type: string
enum:
- UNKNOWN
- CALL
- CREATE
- CREATE2
- CREATE3
- CALLCODE
- DELEGATECALL
- STATICCALL
ContractDeploymentDetails:
type: object
properties:
txHash:
type: string
deployerAddress:
type: string
description: The address that initiated the transaction which deployed this contract.
deployerContractAddress:
type: string
description: The contract address which deployed this contract via smart contract. This field is only populated when the contract was deployed as part of smart contract execution.
required:
- txHash
- deployerAddress
Erc721Contract:
type: object
properties:
name:
type: string
description: The contract name.
examples:
- Wrapped AVAX
description:
type: string
officialSite:
type: string
email:
type: string
logoAsset:
$ref: '#/components/schemas/ImageAsset'
bannerAsset:
$ref: '#/components/schemas/ImageAsset'
color:
type: string
resourceLinks:
type: array
items:
$ref: '#/components/schemas/ResourceLink'
tags:
type: array
items:
type: string
address:
type: string
description: A wallet or contract address in mixed-case checksum encoding.
examples:
- '0x71C7656EC7ab88b098defB751B7401B5f6d8976F'
deploymentDetails:
$ref: '#/components/schemas/ContractDeploymentDetails'
ercType:
type: string
enum:
- ERC-721
symbol:
type: string
description: The contract symbol.
examples:
- WAVAX
required:
- address
- ercType
Erc721Transfer:
type: object
properties:
blockNumber:
type: string
description: The block number on the chain.
examples:
- '339'
blockTimestamp:
type: number
description: The block creation (proposal) timestamp in seconds
examples:
- 1648672486
blockTimestampMilliseconds:
type: number
description: The block creation (proposal) timestamp in milliseconds. Available only after Granite upgrade.
examples:
- 1648672486000
blockHash:
type: string
description: The block hash identifier.
examples:
- '0x17533aeb5193378b9ff441d61728e7a2ebaf10f61fd5310759451627dfca2e7c'
txHash:
type: string
description: The transaction hash identifier.
examples:
- '0x3e9303f81be00b4af28515dab7b914bf3dbff209ea10e7071fa24d4af0a112d4'
from:
$ref: '#/components/schemas/RichAddress'
to:
$ref: '#/components/schemas/RichAddress'
logIndex:
type: number
erc721Token:
$ref: '#/components/schemas/Erc721Token'
required:
- blockNumber
- blockTimestamp
- blockHash
- txHash
- from
- to
- logIndex
- erc721Token
Erc1155Token:
type: object
properties:
address:
type: string
description: A wallet or contract address in mixed-case checksum encoding.
examples:
- '0x71C7656EC7ab88b098defB751B7401B5f6d8976F'
ercType:
type: string
enum:
- ERC-1155
tokenId:
type: string
tokenUri:
type: string
metadata:
$ref: '#/components/schemas/Erc1155TokenMetadata'
required:
- address
- ercType
- tokenId
- tokenUri
- metadata
InternalTransaction:
type: object
properties:
blockNumber:
type: string
description: The block number on the chain.
examples:
- '339'
blockTimestamp:
type: number
description: The block creation (proposal) timestamp in seconds
examples:
- 1648672486
blockTimestampMilliseconds:
type: number
description: The block creation (proposal) timestamp in milliseconds. Available only after Granite upgrade.
examples:
- 1648672486000
blockHash:
type: string
description: The block hash identifier.
examples:
- '0x17533aeb5193378b9ff441d61728e7a2ebaf10f61fd5310759451627dfca2e7c'
txHash:
type: string
description: The transaction hash identifier.
examples:
- '0x3e9303f81be00b4af28515dab7b914bf3dbff209ea10e7071fa24d4af0a112d4'
from:
$ref: '#/components/schemas/RichAddress'
to:
$ref: '#/components/schemas/RichAddress'
internalTxType:
$ref: '#/components/schemas/InternalTransactionOpCall'
value:
type: string
examples:
- '10000000000000000000'
isReverted:
type: boolean
description: True if the internal transaction was reverted.
gasUsed:
type: string
gasLimit:
type: string
required:
- blockNumber
- blockTimestamp
- blockHash
- txHash
- from
- to
- internalTxType
- value
- isReverted
- gasUsed
- gasLimit
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
NativeTransaction:
type: object
properties:
blockNumber:
type: string
description: The block number on the chain.
examples:
- '339'
blockTimestamp:
type: number
description: The block creation (proposal) timestamp in seconds
examples:
- 1648672486
blockTimestampMilliseconds:
type: number
description: The block creation (proposal) timestamp in milliseconds. Available only after Granite upgrade.
examples:
- 1648672486000
blockMinDelayExcess:
type: number
description: Minimum block delay in milliseconds. Available only after Granite upgrade.
examples:
- 7477290
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
Erc20Transfer:
type: object
properties:
blockNumber:
type: string
description: The block number on the chain.
examples:
- '339'
blockTimestamp:
type: number
description: The block creation (proposal) timestamp in seconds
examples:
- 1648672486
blockTimestampMilliseconds:
type: number
description: The block creation (proposal) timestamp in milliseconds. Available only after Granite upgrade.
examples:
- 1648672486000
blockHash:
type: string
description: The block hash identifier.
examples:
- '0x17533aeb5193378b9ff441d61728e7a2ebaf10f61fd5310759451627dfca2e7c'
txHash:
type: string
description: The transaction hash identifier.
examples:
- '0x3e9303f81be00b4af28515dab7b914bf3dbff209ea10e7071fa24d4af0a112d4'
from:
$ref: '#/components/schemas/RichAddress'
to:
$ref: '#/components/schemas/RichAddress'
logIndex:
type: number
value:
type: string
examples:
- '10000000000000000000'
erc20Token:
$ref: '#/components/schemas/Erc20Token'
required:
- blockNumber
- blockTimestamp
- blockHash
- txHash
- from
- to
- logIndex
- value
- erc20Token
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
Erc20Token:
type: object
properties:
address:
type: string
description: A wallet or contract address in mixed-case checksum encoding.
examples:
- '0x71C7656EC7ab88b098defB751B7401B5f6d8976F'
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
ercType:
type: string
enum:
- ERC-20
price:
description: The token price, if available.
allOf:
- $ref: '#/components/schemas/Money'
required:
- address
- name
- symbol
- decimals
- ercType
Erc20TransferDetailsV2:
type: object
properties:
from:
$ref: '#/components/schemas/RichAddress'
to:
$ref: '#/components/schemas/RichAddress'
logIndex:
type: number
value:
type: string
examples:
- '10000000000000000000'
erc20Token:
$ref: '#/components/schemas/Erc20TokenV2'
required:
- from
- to
- logIndex
- value
- erc20Token
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
Network:
type: string
enum:
- mainnet
- fuji
- testnet
ImageAsset:
type: object
properties:
assetId:
type: string
imageUri:
type: string
description: OUTPUT ONLY
TeleporterMessageInfo:
type: object
properties:
teleporterMessageId:
type: string
direction:
$ref: '#/components/schemas/TransactionDirectionType'
sourceChainId:
type: string
description: chain id of the source chain. valid only for destination transactions
destinationChainId:
type: string
description: chain id of the destination chain. valid only for source transactions
required:
- teleporterMessageId
- direction
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://build.avax.network/console/utilities/data-api-keys.
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