Megapilled Data API

Base URL: https://api.megapilled.com — No authentication required. Rate limits apply per IP.

GET /wallet/{address}

Returns token balances for a wallet address.

Request

curl https://api.megapilled.com/wallet/0xcb6ad83a90da0887a3560ebc13887532fcde7d23

Response 200 OK

{
  "status": "success",
  "data": {
    "tokens": [
      {
        "token_standard": "ERC20",
        "token_name": "USDT0",
        "token_symbol": "USDT0",
        "token_decimals": 6,
        "contract_address": "0xb8ce59fc...",
        "balance": "8323741.535991"
      },
      {
        "token_standard": "ERC721",
        "token_name": "Uniswap V3 Positions NFT-V1",
        "token_symbol": "UNI-V3-POS",
        "token_decimals": null,
        "contract_address": "0x2b781c57...",
        "balance": "3"
      }
    ]
  }
}

Token Fields

Notes

• Address is case-insensitive
• Zero balances and tokens with unknown name are excluded
• ERC-1155: one row per (contract, token_id) position
• Ordered by ERC20, then ERC721, then ERC1155
• Maximum 10,000 tokens returned per request

GET /holders/{contract}

Returns the top holders of a token, sorted by balance descending.

Request

curl https://api.megapilled.com/holders/0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb

Response 200 OK

{
  "status": "success",
  "data": {
    "token_metadata": {
      "contract_address": "0xb8ce59fc...",
      "token_standard": "ERC20",
      "token_name": "USDT0",
      "token_symbol": "USDT0",
      "token_decimals": 6
    },
    "total_holders": 6062,
    "holders": [
      {
        "address": "0x6c8e5d46...",
        "balance": "11476592.834513"
      }
    ]
  }
}

Holder Fields

Notes

• Contract address is case-insensitive
• Zero balances are excluded
• total_holders is the count of unique holder addresses
• Returns 404 if the contract is not found
• Maximum 1,000 holders returned per request

Errors

Errors return a JSON object with an error field describing what went wrong:

{ "error": "description" }