VCS API Documentation
VeChain Stats
  • Introduction
  • Getting Started
    • 🗝️Getting an API Key
    • 🔓Authentication
    • 📬Postman
    • ✳️Swagger
  • API Endpoints
    • Account
      • Account Stats
      • ✨Account Extended Stats
      • Account Info
      • ✨Account VTHO Info
      • VET/VTHO Balance
      • ✨Transactions In
      • Transactions Out
      • ✨Token Transfers
      • ✨NFT Transfers
      • ✨DEX Trades
      • DEPRECATED: Internal Transfers
      • Historic VET/VTHO
    • Token
      • Token List
      • Token Info
      • Token Price
      • ✨Token Price List
      • Token Supply
      • ✨VIP180 Balance
      • VIP180 Balance Custom
      • ✨Token Holder List
    • Transaction
      • Transaction Status
      • Transaction Info
    • Block
      • Block Daily Stats
      • Block Info
      • Block Height
      • Block by reference
      • Block by timestamp
    • Contract
      • Contract Stats
      • Contract Info
      • Contract Code
    • NFT
      • NFT Token List
      • NFT Info
      • ✨VIP181 Balance
      • VIP181 Balance Custom
      • ✨NFT Holder List
    • Carbon
      • Address Emission
      • Block Emission
      • Transaction Emission
      • Network Emission
    • Network
      • Network Totals
      • Network Stats
      • Network Gas Stats
      • Authority Nodes
      • ✨Mempool
      • Node Token Count
      • ✨Node Token Stats
      • Thor Instance Size
      • X-Node List
    • API Info
      • API Info
      • API Ping
  • Support
    • FAQ
    • Rate Limits
    • Response HTTP Status
    • Common Error Messages
    • Socials
    • Change Log
  • Visit VeChain Stats
Powered by GitBook
On this page

Was this helpful?

  1. API Endpoints
  2. NFT

VIP181 Balance

Returns the balance of VIP181 NFT tokens from a requested address

https://api.vechainstats.com/v2/nft/vip181
    ?address=0xbBDA54E57f3FfdcF3d28F402326F5DF3a1c63778
    &id=vegas_pop
    &expanded=true
    &VCS_API_KEY=your_api_key

Note : This endpoint is throttled to 10 calls/minute regardless of API Pro tier.

Parameter
Description

address

The address for which you want to know it's token balance.

id (optional)

The ID of a NFT project, can be found in the NFT Token List endpoint. If not set, all NFT projects with a balance over 0 are returned.

expanded

Either true or false. Setting this option to true expands the response with extra information.

{
    "status": {
        "success": true,
        "message": "OK"
    },
    "data": {
        "vegas_pop": {
            "name": "The Hive PoP",
            "amount": 0,
            "contract": "0xfb3b2f8b4f8aae9e7a24ba0bcbb6a49d344f2ef3",
            "token_ids": []
        }
    },
    "meta": {
        "address": "0xbbda54e57f3ffdcf3d28f402326f5df3a1c63778",
        "id": "vegas_pop",
        "expanded": true,
        "nfts_total": 139,
        "timestamp": 1696336252
    }
}
PreviousNFT InfoNextVIP181 Balance Custom

Last updated 1 year ago

Was this helpful?

✨