🧙Addresses

Endpoints and responses for getting address data

General

Get Address Info

GET https://api.pepeanalytics.com/v1/address/:address

Data about a specific wallet address or a contract deployer address.

Includes transaction count, tokens held with respective balances, ETH transaction history, other token transaction history, and much more.

Query Parameters

Name	Type	Description
include_history	Boolean	Get historical address interactions
include_txs	Boolean	Get historical address transactions
is_deployer	Boolean	Include Token Sniffer deployer data

200: OK Successful responses

{
    data: {
      address: string
      ETH: {
        price: {
          rate: number
          diff: number
          diff7d: number
          ts: number
          marketCapUsd: number
          availableSupply: number
          volume24h: number
          volDiff1: number
          volDiff7: number
          volDiff30: number
          diff30d: number
        }
        balance: number
        rawBalance: string
      }
      countTxs: number
      tokens?: [                                # Tokens held by wallet address
        {
          tokenInfo: {
            address: string
            decimals: string
            name: string
            symbol: string
            totalSupply: string
            issuancesCount: number
            lastUpdated: number
            holdersCount: number
            ethTransfersCount: number
            price: boolean
          }
          balance: number
          totalIn: number
          rawBalance: string
        }
        ...
      ]
      history?: [                              # Transaction history excluding ETH
          {
            timestamp: string
            transactionHash: string
            tokenInfo: any
            type: string
            address: string
            from: string
            to: string
            value: any
          }
          ...
      ]
      transactions?: [                          # Strictly ETH transactions
        {
          timestamp: string
          from: string
          to: string
          hash: string
          value: string | number
          input: any
          success: boolean
        }
        ...
      ]
      deployerData?: {                          # If using `is_deployer` param, this is returned
        message: string
        malicious_contracts_count: string | number
        categories: [
          {
            name: string
            types: any[]
            count: string | number
          }
          ...
        ]
        contracts: [
          {
            chainId: number | string
            address: string
            types: any[]
          }
          ...
        ]
      }
    }
    message: 'Success'
    isError: false
}

500: Internal Server Error Error

{
    data: null
    isError: true
    message: any
}

400: Bad Request

{
    data: null
    isError: true
    message: string
}

Transactions

Get Address Transfers

GET https://api.pepeanalytics.com/v1/address/:address/txs

Gets an address' most recent token transfers

Path Parameters

Name	Type	Description
address*	String	Address

Query Parameters

Name	Type	Description
limit	Number	Amount of transfers to date back to (default: 10)

200: OK Successful response

{
    data: [
        {
            timestamp: string;
            from: string;
            to: string;
            hash: string;
            value: string | number;
            input: any;
            success: boolean;
        }
        ...
    ]
    message: 'Success'
    isError: false
}

Balances

Get Address Balances

GET https://api.pepeanalytics.com/v1/address/:address/balances

Gets an address' current token holdings and their respective balances.

Path Parameters

Name	Type	Description
address*	String	Address

200: OK Successful response

{
    data: [
        {
            address: string
            name: string
            symbol: string
            decimals: number
            balance: {
                token: string
                usd: string
            }
            priceUSD: string
        }
        ...
    ]
    message: 'Success',
    isError: false
}

Get Address' Token Balance

GET https://api.pepeanalytics.com/v1/address/:address/balance/:token

Gets a wallet address' current token balance and other related info.

Path Parameters

Name	Type	Description
address*	String	Wallet address
token*	String	Token address or token symbol

200: OK Successful response

{
    data: {
        address: string
        name: string
        symbol: string
        decimals: number
        balance: {
           token: string
           usd: string
        }
        priceUSD: string
    }
    message: 'Success'
    isError: false
}