get_assets
Retrieve cryptocurrency asset holdings for blockchain addresses, including EOAs, contracts, and domain names, to analyze portfolio composition.
Instructions
Get Assets holdings by CryptoAddress
Args:
address: EOA, CA, ENS, CNS, KNS.
Returns:
Dict: where assets is a list of assets
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes |
Implementation Reference
- src/bicscan_mcp/server.py:88-107 (handler)The main handler function for the get_assets MCP tool. It is decorated with @mcp.tool() for registration and implements the logic to query the BICScan API for assets held by the given address.@mcp.tool() async def get_assets(address: str) -> dict: """Get Assets holdings by CryptoAddress Args: address: EOA, CA, ENS, CNS, KNS. Returns: Dict: where assets is a list of assets """ logger.info(f"Getting assets for address: {address}") endpoint = "/v1/scan" data = { "query": address, "sync": True, "assets": True, "engines": ["ofac"], } return await post_request(endpoint, data=data)
- src/bicscan_mcp/server.py:40-65 (helper)Supporting helper function used by get_assets (and other tools) to perform authenticated POST requests to the BICScan API, handling errors and logging.async def post_request( endpoint: str, data: dict[str, Any] | None = None ) -> dict[str, Any] | None: """Make a request to BICScan API with proper error handling.""" headers = { "User-Agent": "bicscan-mcp/1.0", "Accept": "application/json", "X-Api-Key": BICSCAN_API_KEY, } url = urljoin(BICSCAN_API_BASE, endpoint) async with httpx.AsyncClient() as client: try: logger.info(f"Making request to {url}") logger.debug(f"{headers=} {data=}") response = await client.post(url, headers=headers, json=data, timeout=30) response.raise_for_status() logger.info(f"Received response: {response.status_code}") return response.json() except httpx.HTTPStatusError as http_err: logger.error(f"Received response: {http_err}, {response.text}") return response.json() except Exception as e: logger.exception(f"Received response: {e}, {response.text}") return {}