--- name: api.vibe.airforce description: api.vibe.airforce provides two Nansen-powered endpoints for on-chain intelligence: one returns recent DEX trades from Nansen-labeled smart money wallets, and the other screens a batch of token addresses against on-chain market metrics. Both endpoints draw on Nansen's curated wallet labels and data infrastructure. host: api.vibe.airforce --- # api.vibe.airforce This host serves agents that need Nansen-sourced on-chain analytics without direct Nansen API access. It covers two distinct use cases: observing what smart money wallets are trading on DEXes, and comparatively ranking a set of tokens by market cap, liquidity, volume, and netflow. It does not offer real-time price feeds, order book data, or arbitrary wallet lookups. ## When to use this host Use this host when an agent needs Nansen-curated smart money trade data or wants to batch-screen tokens by on-chain metrics. It is the right choice for identifying which tokens smart money is accumulating and for comparative token ranking across a candidate set. Do not use it for real-time price feeds or order book data — use a dedicated price API (e.g., CoinGecko, CoinMarketCap, or a DEX aggregator price endpoint) instead. Do not use it to look up trades for an arbitrary wallet address; it only surfaces Nansen-labeled smart money wallets. For single-token deep-dive analysis or streaming data, a different data provider is more appropriate. ## Capabilities ### Smart Money DEX Activity Returns recent on-chain DEX trades attributed to Nansen-labeled smart money wallets, including token pair details, trade value, FDV, market cap, and trader labels across supported chains. - **`fetch-nansen-smart-money-dex-trades`** — Returns recent DEX trades made by Nansen-labeled smart money wallets across chains, including token pair details, trade value in USD, FDV, market cap, and trader labels. ### Token Screening and Ranking Accepts a list of candidate token addresses and returns ranked results with on-chain metrics including market cap, liquidity, price change, volume, and netflow for comparative filtering. - **`screen-tokens-nansen`** — Screens a list of candidate tokens using Nansen-powered metrics and returns ranked results with market cap, liquidity, price change, volume, and netflow data. ## Workflows ### Smart Money Signal to Token Screening *Use when an agent needs to identify tokens being actively traded by smart money and then rank those tokens by on-chain fundamentals before acting on them.* 1. **`fetch-nansen-smart-money-dex-trades`** — Retrieve recent DEX trades from smart money wallets to extract a candidate list of token addresses currently being bought or sold. 2. **`screen-tokens-nansen`** — Feed the extracted token addresses into the screener to rank them by market cap, liquidity, volume, and netflow, filtering down to the most fundamentally sound candidates. ## Skill reference ### `fetch-nansen-smart-money-dex-trades` **Nansen Smart Money DEX Trades** — Returns recent DEX trades made by Nansen-labeled smart money wallets across chains, including token pair details, trade value in USD, FDV, market cap, and trader labels. *Use when:* Use when an agent needs to monitor or analyze recent on-chain DEX activity from smart money wallets, such as identifying which tokens smart money is buying or selling across Ethereum, Base, and other supported chains. *Not for:* Do not use for real-time price feeds or order book data; use a dedicated price API instead. Not suitable for retrieving trades by a specific arbitrary wallet address — this returns Nansen-curated smart money wallets only. **Returns:** Returns an array of up to 10 smart money DEX trade records per page, each with chain, block timestamp, transaction hash, trader address and label, token pair addresses and symbols, amounts, FDV, market cap, and trade value in USD, plus Nansen metadata indicating credits used. **Example:** `POST https://api.vibe.airforce/api/x402/vibe-tools/data-provider/nansen/smart-money/dex-trades Content-Type: application/json {}` --- ### `screen-tokens-nansen` **Nansen Token Screener** — Screens a list of candidate tokens using Nansen-powered metrics and returns ranked results with market cap, liquidity, price change, volume, and netflow data. *Use when:* Use when an agent needs to filter or rank a set of token addresses by on-chain market metrics such as market cap, liquidity, price change, buy/sell volume, and netflow to identify tokens of interest. *Not for:* Do not use for real-time streaming price feeds or single-token deep-dive analysis; this endpoint is a batch screener for comparative filtering across multiple tokens. **Inputs:** - `candidateTokenIds` (array, required) — Array of token objects to screen, each with an 'id' (token contract address) and 'chainId' (integer chain identifier). - `maxResults` (integer) — Maximum number of results to return from the screener. - `includeReasoning` (boolean) — Whether to include reasoning or explanatory text alongside screener results. - `strictValidation` (boolean) — When true, applies strict validation to input token IDs and rejects malformed entries. **Returns:** Returns a data array of screened token objects, each with chain, token_address, token_symbol, market_cap_usd, liquidity, price_usd, price_change, fdv, buy/sell volume, netflow, and inflow/outflow FDV ratios. **Example:** `{"candidateTokenIds":[{"id":"0xE41d2489571d322189246DaFA5ebDe1F4696fB0e","chainId":1},{"id":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","chainId":8453}],"maxResults":10,"includeReasoning":false,"strictValidation":true}` ---