Tool Catalog - Nikiwa

Nikiwa’s tools are grouped below by subject. Each is deterministic: give it exact inputs (an address, token, transaction hash, or a symbol or name to resolve first) and it returns a structured data object, {status: no_data}, or {status: error}.

The MCP server exposes the full set below. The public Tools API exposes a curated subset. For the authoritative, live list, and each tool’s exact input schema, use the discovery endpoint (GET /api/tools) or the nikiwa://chains and nikiwa://usage MCP resources.

Credits

Each call costs the credits shown in the tables below, taken from your plan’s shared monthly credit pool. A call that returns {status: error} is refunded; a call that returns data or {status: no_data} is charged. Reading MCP resources and using prompts is free. See Credits & Pricing for the full rules.

Resolution

Turn a symbol or an ENS or SNS name into a concrete address before analysis.

Tool	Description	Credits
`resolve_token_symbol`	Resolve a token symbol to its contract address, per network.	1
`resolve_name`	Resolve an ENS (`.eth`) or SNS (`.sol`) name to its wallet address.	1
`resolve_ens`	Deprecated alias of `resolve_name`, kept for existing integrations.	1

Wallet analysis

Tool	Description	Credits
`get_wallet_portfolio_breakdown`	Full portfolio composition and value across chains.	8
`get_wallet_token_holdings`	Token balances held by a wallet.	8
`get_wallet_pnl`	Realized and unrealized profit and loss.	25
`get_wallet_stats`	Aggregate activity statistics for a wallet.	8
`get_wallet_transactions`	Transaction history for a wallet.	25
`get_wallet_transaction_patterns`	Behavioral patterns across a wallet’s transactions.	15
`get_wallet_counterparties`	Addresses a wallet has interacted with.	25
`get_wallet_counterparties_analysis`	Deeper analysis of a wallet’s counterparties.	25
`get_wallet_risk_overview`	High-level risk summary for a wallet.	15
`get_wallet_risk_score`	Numeric risk score for a wallet.	8
`get_wallet_address_profile`	Profile and identity signals for an address.	8
`get_wallet_account_meta`	Account metadata such as labels, tags, and first and last seen.	1
`get_wallet_osint_record`	Open-source intelligence records linked to an address.	1
`get_wallet_deployed_contracts`	Contracts a wallet has deployed.	8
`get_wallet_stablecoin_compliance`	Stablecoin compliance and exposure signals for a wallet.	40
`is_address_blacklisted_by_stablecoin`	Whether an address is currently blacklisted by a stablecoin issuer (Tether or Circle) on a network.	3

Token analysis

Tool	Description	Credits
`get_token_info`	Core token metadata and stats.	3
`get_token_holders_traders`	Top holders and active traders of a token.	15
`get_token_flows`	Inflows and outflows for a token.	15
`get_token_flow_intelligence`	Enriched flow analysis: who is moving the token, and how.	15
`get_token_market_analysis`	Market-level analysis for a token.	8
`get_token_risk_traits`	Risk traits and red flags for a token.	3
`analyze_token_developer`	Analyze a token’s developer or deployer.	25
`analyze_token_website`	Analyze a token’s official website signals.	8

Transactions & contracts

Tool	Description	Credits
`analyze_transaction`	Decode and analyze a transaction by hash.	40
`get_contract_creation`	Creation details, including deployer and transaction, for a contract.	3
`get_contract_source_code`	Verified source code for a contract.	8

Market data

DeFi and market intelligence across protocols and chains.

Tool	Description	Credits
`get_protocols_overview`	Overview of DeFi protocols.	3
`get_protocol_details`	Detailed metrics for a single protocol.	3
`get_chains_tvl`	Total value locked by chain.	3
`get_categories_tvl`	TVL grouped by protocol category.	3
`get_coin_prices`	Prices for one or more coins.	3
`get_stablecoins`	Stablecoin supply and circulation.	3
`get_stablecoin_dominance`	Stablecoin market share and dominance.	3
`get_yields_pools`	Yield-farming pools and APYs.	3
`get_dex_volume`	DEX trading volume.	3
`get_perps_volume`	Perpetuals trading volume.	3
`get_fees_revenue`	Protocol fees and revenue.	3
`get_bridges_overview`	Cross-chain bridge activity.	3
`get_narratives_performance`	Performance of market narratives and sectors.	3
`get_raises`	Fundraising rounds and investments.	3
`get_hacks`	Known exploits and hacks.	3

Prediction markets & perps

Tool	Description	Credits
`search_polymarket`	Search Polymarket events and markets by text.	3
`get_polymarket_activities`	Activity on Polymarket.	3
`get_polymarket_open_bets`	Open positions for a Polymarket user.	3
`get_polymarket_closed_bets`	Closed and settled positions for a Polymarket user.	3
`get_polymarket_user`	Profile and stats for a Polymarket user.	3
`get_hyperliquid_activity`	Trading activity on Hyperliquid.	8

Tool availability and inputs change over time. Treat the discovery endpoint as the source of truth for what is callable and what each tool expects.

​Credits

​Resolution

​Wallet analysis

​Token analysis

​Transactions & contracts

​Market data

​Prediction markets & perps

Credits

Resolution

Wallet analysis

Token analysis

Transactions & contracts

Market data

Prediction markets & perps