hooks
Useaccount

useAccount

Hook for returning details on a specific Aptos account.

import { useAccount } from "aptosjs"

Usage

import { useAccount } from "aptosjs"
 
function App(){
  const { data, loading, error } = useAccount(
    {
      "address": "",
      "network": "mainnet"
    }
  )
 
  if (loading) return <div>Loading...</div>
  if (error) return <div>{error}</div>
  return <div>{data?.balance}</div>
}

Example Return

// Data returned for the following address on mainnet:  0xaf5b13d09028304654615f4d10d0622056912a9696c4d4fbec9d1a7033962594
{
  balance: 5216176148n,
  formatted_balance: "52.16176148 APT",
  tokenCount: 566,
  transactionsCount: 6326,
  coins: [
    {
    amount: 5216176148,
    formatted_amount: "52.16176148 APT",
    name: "Aptos Coin",
    symbol : "APT",
    type:"0x1::aptos_coin::AptosCoin" 
    }
  ],
  nfts: [
    {
      amount: 1,
      collection_id: "7b26443a061a6493aed132597e2348d39c88b4101a23a7a0c7c0677f9245376b", 
      collection_name: "ALPHA DRAGON" ,
      creator_addres: "0xf107df9f3e87cb68b20b84623357c3218689a6eec5595890582520326807a412", 
      description: "766 ALPHA DRAGON ", 
      metadata_https_uri: "https://ipfs.io/ipfs/nftstorage.link/ipfs/bafybeigho5x4ppl2zvr2eew72sei7eyqh64ckfjsgwhc5j2vdxaava5txu/762",
      metadata_uri: "https://nftstorage.link/ipfs/bafybeigho5x4ppl2zvr2eew72sei7eyqh64ckfjsgwhc5j2vdxaava5txu/762", 
      name: "ALPHA DRAGON #762"
    }
  ]
}

Input Values

{
  address: string, 
  network: "devnet" | "testnet" | "mainnet" 
}

Address (required)

The address of the account you want to query.

address: string  

Network (required)

The Aptos network you want to query information from.

network: "devnet" | "testnet" | "mainnet"

Return Values

{
  data: {
    coins: [
      {
        name: string,
        symbol: string,
        type: string,
        amount: Int, 
        formatted_amount: string
      }
      ,...
    ],
    nfts: [
      {
        amount: Int,
        collection_id: string,
        collection_name: string,
        name: string,
        creator_address: string,
        description: string,
        metadata_uri: string,
        metadata_https_uri: string 
      }
      ,...
    ],
    transactionsCount: Int,
    tokenCount: Int, 
    balance: BigInt,
    formatted_balance: string
  },
  loading: boolean,
  error: string | null
}