This class implements the Skynet Web3 API.

To create a SkynetWeb3Provider quickly, call createSkynetProvider with the API key.
To customize headers, call the SkynetWeb3Provider constructor with a tailored ConnectionInfo parameter.

Hierarchy

  • CustomSkynetProvider
    • SkynetWeb3Provider

Accounts

  • Get fungible token balances of an address, including the native token (RON)

    Parameters

    • address: string
    • Optionallimit: number

      how many items can be return in a single response, maximum 200

    • Optionalcursor: string

      the current pointer of the result set, to iterate to the next part of the results, it's returned by the previous call (nextCursor field), you get it and pass to the next call, present nextCursor means there will be more results to scroll, empty nextCursor means it reaches to the end of results

    Returns Promise<get_fungible_token_balance_Response>

    EErrorCodeMessage

  • Get internal tx transfers

    Get all RON transfers via internal transactions of a wallet address

    This API provides a focused view of internal transactions that may indicate potential money movement associated with a specific wallet. This API exclusively returns internal transactions where the Ethereum Virtual Machine (EVM) OpCode is "CALL" signaling that the transaction likely involves a call to another contract, which may result in a transfer of funds.

    The API filters results to include only those internal transactions where either the from or to field matches the provided wallet address. This allows users to efficiently monitor all relevant internal activity linked to their wallet, helping them track significant interactions, such as fund movements or contract engagements.

    By focusing on potential money movements, this API is invaluable for users looking to gain insights into their on-chain behavior and manage their assets effectively.

    Parameters

    • account: string
    • Optionallimit: number

      how many items can be return in a single response, maximum 200

    • Optionalcursor: string

      the current pointer of the result set, to iterate to the next part of the results, it's returned by the previous call (nextCursor field), you get it and pass to the next call, present nextCursor means there will be more results to scroll, empty nextCursor means it reaches to the end of results

    Returns Promise<get_internal_txs_transfers_Response>

    EErrorCodeMessage

  • Get list of collections having NFTs belonging to an address

    Parameters

    • address: string
    • Optionallimit: number

      how many items can be return in a single response, maximum 200

    • Optionalcursor: string

      the current pointer of the result set, to iterate to the next part of the results, it's returned by the previous call (nextCursor field), you get it and pass to the next call, present nextCursor means there will be more results to scroll, empty nextCursor means it reaches to the end of results

    Returns Promise<get_list_of_collections_having_NFTs_Response>

    EErrorCodeMessage

  • Get NFT list of an address and contract

    Parameters

    • address: string
    • contractAddress: string
    • Optionallimit: number

      how many items can be return in a single response, maximum 200

    • Optionalcursor: string

      the current pointer of the result set, to iterate to the next part of the results, it's returned by the previous call (nextCursor field), you get it and pass to the next call, present nextCursor means there will be more results to scroll, empty nextCursor means it reaches to the end of results

    Returns Promise<get_nft_list_of_address_and_contract_Response>

    EErrorCodeMessage

  • Get owned NFTs of an address

    This API allows you to retrieve a list of NFTs owned by a wallet address.

    Parameters

    • address: string

      owner address - The address to retrieve owned NFTs for

    • Optionallimit: number

      how many items can be return in a single response, maximum 200

    • Optionalcursor: string

      the current pointer of the result set, to iterate to the next part of the results, it's returned by the previous call (nextCursor field), you get it and pass to the next call, present nextCursor means there will be more results to scroll, empty nextCursor means it reaches to the end of results

    Returns Promise<get_owned_nfts_of_address_Response>

    EErrorCodeMessage

  • Get token transfers of an address

    Parameters

    • account: string
    • Optionallimit: number

      how many items can be return in a single response, maximum 200

    • Optionalcursor: string

      the current pointer of the result set, to iterate to the next part of the results, it's returned by the previous call (nextCursor field), you get it and pass to the next call, present nextCursor means there will be more results to scroll, empty nextCursor means it reaches to the end of results

    Returns Promise<get_token_tranfers_of_address_Response>

    EErrorCodeMessage

  • Get token transfers of an address with a contract

    Get all token transfers of a wallet address and a contract

    This API offers a more targeted way to track token movements between a specific wallet and a particular smart contract. It is ideal for platforms, traders, and developers who need detailed insights into how tokens are being transferred between a wallet and a specific contract, such as in staking, liquidity pools, or token sale contracts. For NFT and token holders, it allows precise tracking of interactions with a contract, ensuring transparency and control over assets. DeFi projects and investors can use this API to analyze contract-specific transactions like token swaps, staking, or rewards distributed from the contract to the wallet. By narrowing the focus to a single wallet-contract relationship, this API simplifies auditing and enhances security checks, helping users spot patterns or irregularities in token flows. I t’s an essential tool for those who need contract-specific token transfer data without wading through the noise of all wallet transactions

    Parameters

    • account: string

      wallet address

    • contractAddress: string

      contract address

    • Optionallimit: number

      how many items can be return in a single response, maximum 200

    • Optionalcursor: string

      the current pointer of the result set, to iterate to the next part of the results, it's returned by the previous call (nextCursor field), you get it and pass to the next call, present nextCursor means there will be more results to scroll, empty nextCursor means it reaches to the end of results

    Returns Promise<get_token_tranfers_of_address_with_contract_Response>

    EErrorCodeMessage

  • Get transactions of an address

    Get all transactions of a wallet address

    This API provides comprehensive access to every blockchain transaction associated with a specific wallet address. Unlike token transfers, which are derived from event logs, this API returns raw blockchain transactions, including contract interactions, token approvals, and transfers. This is invaluable for developers, investors, and platforms needing a full overview of a wallet's blockchain activity. For DeFi users, it offers transparency into all on-chain actions, whether interacting with smart contracts or moving assets between wallets. NFT collectors and creators can use this API to track every significant transaction related to their assets, such as minting or contract deployments. By providing a complete history of blockchain transactions, this API is essential for auditing, monitoring, and managing wallets, helping users maintain full visibility into their on-chain behavior, including interactions that don't necessarily involve token transfers.

    A blockchain transaction relates to a wallet through the from, to, and contractAddress fields. The from field indicates the sender; if it matches the wallet address, it means the wallet initiated the transaction, such as sending tokens or RON. The to field represents the recipient; if this matches the wallet, it signifies that the wallet received assets. The contractAddress specifies any smart contract involved in the transaction. If this address matches a specific contract the wallet interacts with, it shows the relationship between the wallet and that contract.

    Parameters

    • account: string
    • Optionallimit: number

      how many items can be return in a single response, maximum 200

    • Optionalcursor: string

      the current pointer of the result set, to iterate to the next part of the results, it's returned by the previous call (nextCursor field), you get it and pass to the next call, present nextCursor means there will be more results to scroll, empty nextCursor means it reaches to the end of results

    Returns Promise<get_transactions_of_address_Response>

    EErrorCodeMessage

Blocks

Collections

  • Get collection holder list

    Get all owners of a collection

    This API allows you to retrieve a list of wallet addresses that own NFTs from a specific collection along with NFTs amounts they own.

    Parameters

    • contractAddress: string

      The address to get collection holder list for

    • Optionallimit: number

      how many items can be return in a single response, maximum 200

    • Optionalcursor: string

      the current pointer of the result set, to iterate to the next part of the results, it's returned by the previous call (nextCursor field), you get it and pass to the next call, present nextCursor means there will be more results to scroll, empty nextCursor means it reaches to the end of results

    Returns Promise<get_collection_holder_list_Response>

    EErrorCodeMessage

  • Get collection token transfers

    Parameters

    • contractAddress: string

      The address to get token transfers for

    • Optionallimit: number

      how many items can be return in a single response, maximum 200

    • Optionalcursor: string

      the current pointer of the result set, to iterate to the next part of the results, it's returned by the previous call (nextCursor field), you get it and pass to the next call, present nextCursor means there will be more results to scroll, empty nextCursor means it reaches to the end of results

    Returns Promise<get_collection_token_transfers_Response>

    EErrorCodeMessage

  • Get NFTs from a collection

    This API is a must-have for game studios looking to efficiently manage their on-chain assets. With one simple request, game developers can access all NFTs in as collection. Game studios often deal with large volumes of NFTs, from in-game items to collectibles. This API provides an easy way to retrieve and organize all assets in a collection, helping teams focus on game development, not blockchain complexity. Ensure your NFT-based assets are accurately tracked and managed on-chain, providing transparency and security for both the studio and its players. No need for deep blockchain knowledge—this API handles the heavy lifting.

    Parameters

    • contractAddress: string
    • Optionallimit: number

      how many items can be return in a single response, maximum 200

    • Optionalcursor: string

      the current pointer of the result set, to iterate to the next part of the results, it's returned by the previous call (nextCursor field), you get it and pass to the next call, present nextCursor means there will be more results to scroll, empty nextCursor means it reaches to the end of results

    Returns Promise<get_nfts_from_collection_Response>

    EErrorCodeMessage

  • Get the number of collection holdings by address

    Parameters

    • contractAddress: string

      The address to get the number of collection holders for

    • address: string

      The account address

    • Optionallimit: number

      how many items can be return in a single response, maximum 200

    • Optionalcursor: string

      the current pointer of the result set, to iterate to the next part of the results, it's returned by the previous call (nextCursor field), you get it and pass to the next call, present nextCursor means there will be more results to scroll, empty nextCursor means it reaches to the end of results

    Returns Promise<get_number_of_collection_holdings_by_address_Response>

    EErrorCodeMessage

  • Get owners of an NFT

    The most efficient way to access NFT ownership data. Whether you're building a marketplace, verifying digital assets, or analyzing trends in the NFT space, our API provides a streamlined solution to gather ownership information faster and more reliably than traditional.

    You can travel through the whole list of owners in case an NFT has more than one owner.

    Parameters

    • contractAddress: string
    • tokenId: number

    Returns Promise<get_owners_of_nft_Response>

    EErrorCodeMessage

  • Get token transfers of an NFT

    Get all token transfers of an NFT

    This API is a powerful tool to track the complete transfer history of any NFT. This API is invaluable for NFT creators, collectors, and marketplaces, providing detailed insights into every transaction an NFT has gone through. For collectors and investors, it enables easy tracking of an NFT’s provenance. NFT game studios and creators can also benefit from this API to monitor the distribution and movement of their assets across different users.

    Parameters

    • contractAddress: string

      collection address

    • tokenId: number

      NFT ID

    • Optionallimit: number

      how many items can be return in a single response, maximum 200

    • Optionalcursor: string

      the current pointer of the result set, to iterate to the next part of the results, it's returned by the previous call (nextCursor field), you get it and pass to the next call, present nextCursor means there will be more results to scroll, empty nextCursor means it reaches to the end of results

    Returns Promise<get_token_transfers_of_nft_Response>

    EErrorCodeMessage

  • Refresh NFTs of a collection in synchronous manner

    By using this API, users have to wait until the API complete the refreshing process, tokenIds list can be specified in the request body as well as the maxWait duration in milliseconds (the maximum amount of wait time this call can accept). Without its presence, the API treat it as server default timeout of 10 seconds.

    In the response, there are two lists, successes and failures tokenIds, failure reasons can vary and not be exposed. If an NFT keeps failing for a long time, you'd better contact developer support.

    Parameters

    • contractAddress: string
    • tokenIds: string[]
    • maxWait: number

      milliseconds, when maxWait exceeds server timeout, then server timeout will be used instead

    Returns Promise<refresh_nfts_of_collection_sync_Response>

    EErrorCodeMessage

Contracts

Logs

  • Get logs by contract address

    Parameters

    • contractAddress: string
    • Optionallimit: number

      how many items can be return in a single response, maximum 200

    • Optionalcursor: string

      the current pointer of the result set, to iterate to the next part of the results, it's returned by the previous call (nextCursor field), you get it and pass to the next call, present nextCursor means there will be more results to scroll, empty nextCursor means it reaches to the end of results

    Returns Promise<get_logs_by_contract_address_Response>

    EErrorCodeMessage

  • Get logs by contract address and log topic

    Parameters

    • contractAddress: string
    • topic: string
    • Optionallimit: number

      how many items can be return in a single response, maximum 200

    • Optionalcursor: string

      the current pointer of the result set, to iterate to the next part of the results, it's returned by the previous call (nextCursor field), you get it and pass to the next call, present nextCursor means there will be more results to scroll, empty nextCursor means it reaches to the end of results

    Returns Promise<get_logs_by_contract_address_and_log_topic_Response>

    EErrorCodeMessage

NFTs

Other

connection: ConnectionInfo
  • Protected

    Sends HTTP GET message to the service provider

    Parameters

    • urlSuffix: string
    • Optionalconfig: AxiosRequestConfig<any>

    Returns Promise<AxiosResponse<any, any>>

  • Places a call to the service, with optional limits and cursor

    Parameters

    • url: string
    • Optionallimit: number

      how many items can be return in a single response, maximum 200

    • Optionalcursor: string

      the current pointer of the result set, to iterate to the next part of the results, it's returned by the previous call (nextCursor field), you get it and pass to the next call, present nextCursor means there will be more results to scroll, empty nextCursor means it reaches to the end of results

    Returns Promise<any>

  • Protected

    Sends HTTP POST message to the service provider

    Parameters

    • urlSuffix: string
    • data: any

    Returns Promise<AxiosResponse<any, any>>

  • Updates the url to include limit and cursors, if they're provided.

    Parameters

    • url: string
    • Optionallimit: number

      how many items can be return in a single response, maximum 200

    • Optionalcursor: string

      the current pointer of the result set, to iterate to the next part of the results, it's returned by the previous call (nextCursor field), you get it and pass to the next call, present nextCursor means there will be more results to scroll, empty nextCursor means it reaches to the end of results

    Returns string

    Updated url if limit and cursors provided, otherwise, returns the parameter url.

  • Parameters

    • url: string
    • params: string | URLSearchParams

    Returns string

Token transfers

Transactions