--- name: agenthustle.ai description: agenthustle.ai provides two data retrieval skills: a multi-chain token balance snapshot across seven networks (Solana, Ethereum, BSC, Polygon, Base, Hedera, Bitcoin) and a paginated trading leaderboard for the Hustle/Emblem ecosystem. Both skills require API key and JWT authentication and return structured JSON with current USD pricing or ranked trader metrics. host: agenthustle.ai --- # agenthustle.ai agenthustle.ai is a data host tied to the Hustle/Emblem ecosystem, serving agents that need portfolio visibility across major EVM, Solana, and Bitcoin networks or ranked trader analytics within that ecosystem. It is not a general-purpose DEX aggregator or price oracle; its value is in combining multi-chain balance aggregation with ecosystem-specific leaderboard data under a single authentication model. ## When to use this host Use agenthustle.ai when an agent needs a one-shot multi-chain balance snapshot for an address spanning Ethereum, BSC, Polygon, Base, Solana, Hedera, and Bitcoin, or when it needs ranked trader data specific to the Hustle/Emblem ecosystem. Do not use this host for real-time streaming price feeds, historical balance queries, individual trade history, or on-chain execution — it is read-only and snapshot-based. For single-chain balance queries, a chain-specific RPC or indexer will be more efficient since fetch-all-chain-balances fans out to all networks regardless. For broader DEX analytics or cross-ecosystem leaderboards outside Hustle/Emblem, a general-purpose DeFi data provider would be more appropriate. ## Capabilities ### Multi-Chain Portfolio Snapshot Retrieves token balances and current USD prices for a given address across all supported networks in a single call, covering native and ERC-20/SPL holdings. - **`fetch-all-chain-balances`** — Fetches token balances across Solana, Ethereum, BSC, Polygon, Base, Hedera, and Bitcoin for a connected vault or a specified override address, returning per-network token lists with metadata and USD prices. ### Ecosystem Trading Rankings Returns paginated, sortable leaderboard data for Hustle/Emblem traders, enabling ranking by volume, PnL, transactions, referrals, or aura score, with optional address or username search. - **`fetch-hustle-trading-leaderboard`** — Returns a paginated slice of the Hustle/Emblem ecosystem trading leaderboard, sortable by volume, transactions, referrals, aura score, or PnL. ## Workflows ### Trader Portfolio Audit *Use when an agent needs to identify a top-ranked trader from the leaderboard and then inspect their current multi-chain holdings.* 1. **`fetch-hustle-trading-leaderboard`** — Query the leaderboard sorted by PnL or volume to retrieve the target trader's wallet address. 2. **`fetch-all-chain-balances`** — Pass the retrieved wallet address to get a full multi-chain token balance snapshot with USD valuations. ## Skill reference ### `fetch-all-chain-balances` **AllChain Balance Checker** — Fetches token balances across Solana, Ethereum, BSC, Polygon, Base, Hedera, and Bitcoin for a connected vault or a specified override address, returning per-network token lists with metadata and USD prices. *Use when:* Use when an agent needs a multi-chain token balance snapshot for an EVM, Solana, or Bitcoin address, including native and ERC-20/SPL token holdings with current USD price data across all supported networks in a single call. *Not for:* Do not use for real-time streaming price feeds or historical balance queries; this is a single-shot snapshot. Do not use if you only need balances on one specific chain — the call fans out to all supported networks regardless. **Inputs:** - `apiKey` (string) — (Required: provide apiKey OR emblemJwt) Vault API key — alternative to JWT for authenticating vault/wallet access. - `emblemJwt` (string) — (Required: provide emblemJwt OR apiKey) Emblem Vault JWT — grants wallet/vault access for the authenticated session. - `address` (string) — Optional override address to query on behalf of another wallet. EVM (0x…) fans out to ethereum/bsc/polygon/base/hedera; Solana base58 goes to solana; Bitcoin 33-byte compressed pubkey hex goes to bitcoin. Chains whose format does not match return an address type mismatch error. **Returns:** Returns a result object keyed by chain (ethereum, bsc, polygon, base, solana, hedera, bitcoin), each containing a tokens array with tokenBalance, humanReadableBalance, tokenMetadata, and USD tokenPrices; chains with address format mismatches return an error field instead. **Example:** `{"apiKey": "vk_live_abc123xyz", "address": "0x402Feee072D655B85e08f1751AF9ddbCd249521f"}` --- ### `fetch-hustle-trading-leaderboard` **Hustle Trading Leaderboard** — Returns a paginated slice of the Hustle/Emblem ecosystem trading leaderboard, sortable by volume, transactions, referrals, aura score, or PnL. *Use when:* Use when an agent needs ranked trader data from the Hustle ecosystem, such as top traders by volume or PnL, or when searching for a specific address or username on the leaderboard. *Not for:* Do not use for real-time price feeds or individual trade history; this returns aggregated leaderboard rankings only. **Inputs:** - `page` (number) — Page number of the leaderboard results. Defaults to 1. - `pageSize` (number) — Number of entries per page. Defaults to 20. - `orderBy` (string) — Field to sort the leaderboard by. One of: volume, transactions, referrals, aura, pnl. Defaults to volume. - `query` (string) — Optional search string to filter leaderboard entries by address or username. - `apiKey` (string) — Vault API key — alternative to JWT authentication. - `emblemJwt` (string) — Emblem Vault JWT for authenticated requests; not required for this info-only tool. **Returns:** Returns a result.data array of up to 25 leaderboard entries each with address, trading_volume, transaction_count, unique_users_referred, auraScore, twitterUsername, and totalPnL, plus a timestamp and callerType. **Example:** `{"page": 2, "pageSize": 25, "orderBy": "pnl", "query": ""}` ---