Wallet API — Monad Atlas Docs

Base URL

https://api.monadatlas.com/api/

All responses include historicalCoverageStartBlock (earliest block in index).

wallet_summary

Normalized wallet activity: tx count, native MON in/out, unique tokens, first funding source. One call for a quick read.

Param	Required	Description
`address`	Yes	Wallet address (0x + 40 hex)

GET /api/wallet_summary?address=0x...

Returns: firstSeenBlock, lastSeenBlock, txCount, uniqueTokens, nativeReceived, nativeSent, firstFundingSource, lastActivity

wallet_funding_source

First inbound transfer for a wallet. Answers: who funded this wallet? Useful for launchpad tools (fresh vs exchange-funded).

GET /api/wallet_funding_source?address=0x...

Returns: from, amount, txHash, blockNumber, timestamp

wallet_counterparties

Addresses a wallet interacts with most. Who does this wallet send to / receive from?

Param	Default	Description
`address`	—	Wallet address
`limit`	50	Max counterparties (max 200)

GET /api/wallet_counterparties?address=0x...&limit=20

address_transfers

Historical transfers for a wallet. Native MON, ERC20, ERC721, ERC1155 in one feed. Cursor-based pagination.

Param	Required	Description
`address`	Yes	Wallet address
`direction`	No	`in` \| `out` \| `both` (default)
`limit`	No	Max results (default 100, max 500)
`cursor`	No	Pagination cursor (last `id` from previous page)
`before_block`	No	Only transfers at or before this block
`after_block`	No	Only transfers at or after this block

GET /api/address_transfers?address=0x...&limit=20

Response: transfers (array), nextCursor, count, historicalCoverageStartBlock

transferType: native_direct | erc20 | erc721 | erc1155

wallet_label

Auto-classify a wallet based on on-chain behavior. Returns labels like fresh, whale, bot_likely, trader, contract_likely, high_activity, or regular.

GET /api/wallet_label?address=0x...

Response:

{
  "address": "0x...",
  "labels": ["whale", "trader"],
  "confidence": "high",
  "stats": {
    "txCount": 12500,
    "uniqueTokens": 45,
    "nativeInMon": "50000.00",
    "nativeOutMon": "48000.00",
    "ageBlocks": 500000,
    "firstBlock": 71300000,
    "lastBlock": 72400000,
    "firstFunder": "0x..."
  }
}

Label	Criteria
`fresh`	Less than 1000 blocks old, fewer than 20 transactions
`whale`	More than 10,000 MON received or sent
`bot_likely`	More than 0.5 transactions per block over 500+ transactions
`high_activity`	More than 5,000 total transactions
`trader`	Interacted with 20+ unique tokens
`contract_likely`	Receives many internal transfers but no token activity
`casual`	1-3 unique tokens, fewer than 50 transactions
`regular`	Default when no other label applies

wallets/batch

Bulk wallet summary lookup. Submit up to 100 addresses and get summaries for all of them in one call.

POST /api/wallets/batch
Content-Type: application/json

{
  "addresses": ["0xabc...", "0xdef...", "0x123..."]
}

Response:

{
  "wallets": {
    "0xabc...": {
      "firstSeenBlock": 71300000,
      "lastSeenBlock": 72400000,
      "txCount": 150,
      "lastActivity": "2026-05-04T12:00:00.000Z",
      "firstFunder": "0xdef...",
      "firstFundingBlock": 71300000
    },
    "0x123...": null
  },
  "count": 3
}

Note: Addresses with no indexed activity return null. Max 100 addresses per request.