# Nikiwa

> Nikiwa is a blockchain wallet and token analysis platform. Docs for the app, the public Tools API, and the MCP server.

## Docs

- [Authentication](https://docs.nikiwa.com/api-reference/authentication.md): Authenticate to the Nikiwa Tools API with a developer key.
- [Discover Tools](https://docs.nikiwa.com/api-reference/discovery.md): List the public tools and read their input specs.
- [Errors & Status](https://docs.nikiwa.com/api-reference/errors.md): HTTP status codes and the in-body status markers Nikiwa tools return.
- [Execute a Tool](https://docs.nikiwa.com/api-reference/execute.md): Call a Nikiwa tool and get its structured result.
- [API Overview](https://docs.nikiwa.com/api-reference/overview.md): The Nikiwa public Tools API, a REST surface for discovering and executing blockchain analysis tools.
- [Rate Limits & Metering](https://docs.nikiwa.com/api-reference/rate-limits.md): Per-key rate limits and how tool usage is metered.
- [analyze_token_developer](https://docs.nikiwa.com/api-reference/tools-api/analyze_token_developer.md): Deployer/developer analysis for a token contract (creator history, related deploys).
- [analyze_token_website](https://docs.nikiwa.com/api-reference/tools-api/analyze_token_website.md): Token website/domain analysis: whois age/privacy/registry + blocklist signals.
- [analyze_transaction](https://docs.nikiwa.com/api-reference/tools-api/analyze_transaction.md): Decode and classify a single transaction (participants, value flow, risk flags).
- [get_contract_creation](https://docs.nikiwa.com/api-reference/tools-api/get_contract_creation.md): Deployer address + creation transaction for a contract. EVM only.
- [get_contract_source_code](https://docs.nikiwa.com/api-reference/tools-api/get_contract_source_code.md): Verified contract source code + ABI (EVM chains). Note: response can be large.
- [get_token_flow_intelligence](https://docs.nikiwa.com/api-reference/tools-api/get_token_flow_intelligence.md): Smart-money / exchange flow intelligence for a token. timeframe: 5m/1h/6h/12h/1d/7d.
- [get_token_flows](https://docs.nikiwa.com/api-reference/tools-api/get_token_flows.md): Token flows by cohort. label: smart_money/whale/exchange/public_figure/top_100_holders.
- [get_token_holders_traders](https://docs.nikiwa.com/api-reference/tools-api/get_token_holders_traders.md): Top holders + trader PnL/concentration for a token.
- [get_token_info](https://docs.nikiwa.com/api-reference/tools-api/get_token_info.md): Token metadata (name, symbol, supply, decimals, basic profile) for a contract.
- [get_token_market_analysis](https://docs.nikiwa.com/api-reference/tools-api/get_token_market_analysis.md): Market analysis for a token: liquidity, volume, supply, price signals.
- [get_token_risk_traits](https://docs.nikiwa.com/api-reference/tools-api/get_token_risk_traits.md): Token contract risk traits: taxes, ownership, liquidity, honeypot/security flags.
- [get_wallet_account_meta](https://docs.nikiwa.com/api-reference/tools-api/get_wallet_account_meta.md): Account metadata for a wallet (account type, label).
- [get_wallet_address_profile](https://docs.nikiwa.com/api-reference/tools-api/get_wallet_address_profile.md): Address profile: platform usage + malicious-event history (MistTrack).
- [get_wallet_counterparties](https://docs.nikiwa.com/api-reference/tools-api/get_wallet_counterparties.md): Top counterparties a wallet transacts with, ranked by volume. Supports paging.
- [get_wallet_counterparties_analysis](https://docs.nikiwa.com/api-reference/tools-api/get_wallet_counterparties_analysis.md): Counterparty analysis: most-interacted + top inflow/outflow addresses for a wallet.
- [get_wallet_deployed_contracts](https://docs.nikiwa.com/api-reference/tools-api/get_wallet_deployed_contracts.md): Contracts deployed by a wallet.
- [get_wallet_osint_record](https://docs.nikiwa.com/api-reference/tools-api/get_wallet_osint_record.md): OSINT records linked to a wallet (Nikiwa address book).
- [get_wallet_pnl](https://docs.nikiwa.com/api-reference/tools-api/get_wallet_pnl.md): Detailed realized/unrealized PnL for a wallet (per-token, with totals).
- [get_wallet_portfolio_breakdown](https://docs.nikiwa.com/api-reference/tools-api/get_wallet_portfolio_breakdown.md): Portfolio breakdown: major/top holdings, total value, and composition analysis.
- [get_wallet_risk_overview](https://docs.nikiwa.com/api-reference/tools-api/get_wallet_risk_overview.md): Address risk overview (label/profile/exposure summary) for a wallet.
- [get_wallet_risk_score](https://docs.nikiwa.com/api-reference/tools-api/get_wallet_risk_score.md): Risk/security snapshot for a wallet (sanctions, scam, mixer, behavioral signals).
- [get_wallet_stablecoin_compliance](https://docs.nikiwa.com/api-reference/tools-api/get_wallet_stablecoin_compliance.md): Full stablecoin (USDT/USDC) compliance HISTORY for an address — every blacklist / unblacklist / freeze event with its timestamp. Auto-detects the address's chain across EVM chains, Tron, Solana, and Bitcoin — no network argument needed.
- [get_wallet_stats](https://docs.nikiwa.com/api-reference/tools-api/get_wallet_stats.md): Activity stats for a wallet: per-token sent/received, first/last activity, labels.
- [get_wallet_token_holdings](https://docs.nikiwa.com/api-reference/tools-api/get_wallet_token_holdings.md): Token holdings (symbol, balance, USD value) for a wallet on one network or 'all'.
- [get_wallet_transaction_patterns](https://docs.nikiwa.com/api-reference/tools-api/get_wallet_transaction_patterns.md): Behavioral transaction patterns for a wallet (activity cadence, flow patterns).
- [get_wallet_transactions](https://docs.nikiwa.com/api-reference/tools-api/get_wallet_transactions.md): Recent transactions for a wallet from chain-native sources. Supports paging.
- [is_address_blacklisted_by_stablecoin](https://docs.nikiwa.com/api-reference/tools-api/is_address_blacklisted_by_stablecoin.md): Is an address CURRENTLY blacklisted by Tether (USDT) or Circle (USDC) on a given network, plus the latest blacklist / unblacklist timestamps. issuer must be 'tether' or 'circle'. Supported networks: ethereum, polygon, bnb, arbitrum, optimism, avalanche, base, tron, solana, bitcoin (the address must…
- [List available tools (catalog + selection guide)](https://docs.nikiwa.com/api-reference/tools-api/list-available-tools-catalog-+-selection-guide.md)
- [resolve_ens](https://docs.nikiwa.com/api-reference/tools-api/resolve_ens.md): Resolve an ENS name (e.g. vitalik.eth) to an Ethereum address.
- [resolve_token_symbol](https://docs.nikiwa.com/api-reference/tools-api/resolve_token_symbol.md): Resolve a token symbol/name to contract addresses across networks.
- [Glossary](https://docs.nikiwa.com/essentials/glossary.md): Key terms used across the Nikiwa app, API, and MCP server.
- [Supported Networks](https://docs.nikiwa.com/essentials/supported-networks.md): The chains Nikiwa can analyze.
- [Introduction](https://docs.nikiwa.com/introduction.md): Nikiwa is a blockchain wallet and token analysis platform, available as a chat app, a public API, and an MCP server.
- [API Keys](https://docs.nikiwa.com/mcp/api-keys.md): Create, use, and revoke Nikiwa developer keys for the Tools API and MCP server.
- [Connect with OAuth](https://docs.nikiwa.com/mcp/connect-oauth.md): Connect Claude, ChatGPT, or another MCP client to Nikiwa using OAuth.
- [MCP Server](https://docs.nikiwa.com/mcp/overview.md): Connect Claude, ChatGPT, or any MCP client to Nikiwa's blockchain intelligence tools.
- [Tool Catalog](https://docs.nikiwa.com/mcp/tools.md): Every analysis tool Nikiwa exposes, grouped by what it analyzes.
- [Usage & Metering](https://docs.nikiwa.com/mcp/usage.md): Track per-key tool usage: current-period units, lifetime totals, and a per-tool breakdown.
- [Address Book](https://docs.nikiwa.com/product/address-book.md): Save, label, and manage the blockchain addresses you care about.
- [Chat & Address Detection](https://docs.nikiwa.com/product/chat.md): How the chat interface works, and how Nikiwa detects blockchain addresses in your messages.
- [Modules & Citations](https://docs.nikiwa.com/product/modules.md): The interactive blocks Nikiwa renders inside an answer, and the citations behind them.
- [Overview](https://docs.nikiwa.com/product/overview.md): What the Nikiwa app does, and how a question becomes an answer.
- [Quickstart](https://docs.nikiwa.com/quickstart.md): Get your first Nikiwa result through the app, the Tools API, or an MCP client.

## OpenAPI Specs

- [openapi](https://docs.nikiwa.com/api-reference/openapi.json)