Nansen API

https://docs.nansen.ai
Admin
The Nansen API offers programmatic access to high-quality onchain data and advanced blockchain...
Tokens:243,403
Snippets:637
Trust Score:9.9
Update:9 months ago
Show doc for...
Tokens:
Raw
### GET /websites/nansen_ai/token_screener

Source: https://docs.nansen.ai/getting-started/make-your-first-api-call

Retrieves a paginated list of tokens based on specified screening and sorting criteria. This endpoint allows filtering tokens by blockchain, market cap, liquidity, price, and more, with options to sort the results.

```APIDOC
## GET /websites/nansen_ai/token_screener

### Description
Retrieves a paginated list of tokens based on specified screening and sorting criteria. This endpoint allows filtering tokens by blockchain, market cap, liquidity, price, and more, with options to sort the results.

### Method
GET

### Endpoint
/websites/nansen_ai/token_screener

### Parameters
#### Query Parameters
- **chain** (string) - Optional - The blockchain network to filter tokens by (e.g., 'ethereum', 'bnb_smart_chain').
- **sort_by** (string) - Optional - The field to sort the results by. Accepts values from `TokenScreenerSortField` enum.
- **sort_direction** (string) - Optional - The direction of sorting. Accepts 'ASC' or 'DESC' from `SortDirection` enum. Defaults to 'DESC'.
- **page_size** (integer) - Optional - The number of results per page. Defaults to 50.
- **page_number** (integer) - Optional - The page number to retrieve. Defaults to 1.
- **min_market_cap_usd** (number) - Optional - Minimum market capitalization in USD.
- **min_liquidity** (number) - Optional - Minimum total on-chain liquidity in USD.
- **min_price_usd** (number) - Optional - Minimum price of the token in USD.
- **max_price_usd** (number) - Optional - Maximum price of the token in USD.
- **min_price_change** (number) - Optional - Minimum price change percentage.
- **max_price_change** (number) - Optional - Maximum price change percentage.
- **min_fdv** (number) - Optional - Minimum Fully Diluted Valuation in USD.
- **min_fdv_mc_ratio** (number) - Optional - Minimum ratio of Fully Diluted Valuation to Market Cap.
- **min_buy_volume** (number) - Optional - Minimum total buy volume in USD.
- **min_sell_volume** (number) - Optional - Minimum total sell volume in USD.
- **min_netflow** (number) - Optional - Minimum net flow (buy_volume - sell_volume) in USD.
- **min_token_age_days** (integer) - Optional - Minimum age of the token in days since deployment.

### Request Example
```
GET /websites/nansen_ai/token_screener?chain=ethereum&sort_by=market_cap_usd&sort_direction=DESC&min_market_cap_usd=100000000
```

### Response
#### Success Response (200)
- **data** (array) - List of token screening results. Each item is an object conforming to `TokenScreenerDataDefault` or `TokenScreenerDataNonDefault`.
- **pagination** (object) - Pagination information including `page_number`, `page_size`, `total_pages`, and `total_tokens`.

#### Response Example
```json
{
  "data": [
    {
      "chain": "ethereum",
      "token_address": "0x...",
      "token_symbol": "ETH",
      "token_age_days": 2500,
      "market_cap_usd": 200000000000,
      "liquidity": 50000000000,
      "price_usd": 3000,
      "price_change": 1.5,
      "fdv": 200000000000,
      "fdv_mc_ratio": 1.0,
      "buy_volume": 1000000000,
      "inflow_fdv_ratio": 0.005,
      "outflow_fdv_ratio": 0.004,
      "sell_volume": 800000000,
      "volume": 1800000000,
      "netflow": 200000000,
      "nof_traders": 100000,
      "nof_buyers": 70000,
      "nof_sellers": 60000,
      "nof_buys": 500000,
      "nof_sells": 400000
    }
  ],
  "pagination": {
    "page_number": 1,
    "page_size": 50,
    "total_pages": 10,
    "total_tokens": 500
  }
}
```
```

--------------------------------

### Profiler Endpoints - Migration Guide

Source: https://docs.nansen.ai/api/api-changelog/2025-08-29-major-api-restructuring

Details on migrating Profiler endpoints from beta to v1, including renamed endpoints and changes in request/response structures.

```APIDOC
## Profiler Endpoints - Migration

This section details the migration of Profiler endpoints from the beta version to v1.

### **`/beta/profiler/address/balances` → `/api/v1/profiler/address/current-balance`**

**Description:** The address balances endpoint has been renamed to `current-balance` for greater specificity. The request and response structures have been updated to align with v1 standards, including the adoption of snake_case for field names and a simplified parameter structure.

**Changes:**
*   Renamed from `balances` to `current-balance`.
*   Request and response structures updated to v1 standards.
*   Parameters and response fields now use snake_case.
*   Nested `parameters` wrapper removed from requests.
```

--------------------------------

### Smart Money Endpoints - Migration Guide

Source: https://docs.nansen.ai/api/api-changelog/2025-08-29-major-api-restructuring

Details on migrating Smart Money related endpoints from beta to v1, including renamed endpoints and changes in request/response structures.

```APIDOC
## Smart Money Endpoints - Migration

This section details the migration of Smart Money endpoints from the beta version to v1.

### **`/beta/smart-money/inflows` → `/api/v1/smart-money/netflow`**

**Description:** This endpoint has been renamed from `inflows` to `netflow` for improved clarity. The request structure is simplified by removing the `parameters` wrapper. It now offers enhanced filtering capabilities, comprehensive sorting options, and the response includes pagination metadata.

**Changes:**
*   Renamed from "inflows" to "netflow" for clarity
*   Request structure simplified (no `parameters` wrapper)
*   Enhanced filtering capabilities
*   Added comprehensive sorting options
*   Response includes pagination metadata

**New Features in V1:**
*   `remove_scam_tokens` filter
*   `hide_spam_tokens` filter
*   `token_sector` filter
*   Custom sort ordering support

### **`/beta/smart-money/holdings` → `/api/v1/smart-money/holdings`**

**Description:** The holdings endpoint has been updated with a direct request body structure, enhanced response with pagination, an improved filtering system, and added sort customization.

**Changes:**
*   Direct request body structure
*   Enhanced response with pagination
*   Improved filtering system
*   Added sort customization

### **`/beta/smart-money/dex-trades` → `/api/v1/smart-money/dex-trades`**

**Description:** The DEX trades endpoint now features a simplified request structure, comprehensive trade filters, enhanced label filtering, and improved response metadata.

**Changes:**
*   Simplified request structure
*   Added comprehensive trade filters
*   Enhanced label filtering
*   Improved response metadata

### **`/beta/smart-money/dcas` → `/api/v1/smart-money/dcas`**

**Description:** The DCAS endpoint has been standardized in its request and response format, with enhanced filtering for DCA parameters and added sort capabilities.

**Changes:**
*   Standardized request/response format
*   Enhanced filtering for DCA parameters
*   Added sort capabilities
```

--------------------------------

### GET /v2/smart_money/netflow

Source: https://docs.nansen.ai/api/smart-money/netflows

Fetches a list of smart money netflow records for tokens. Supports filtering by various parameters and pagination.

```APIDOC
## GET /v2/smart_money/netflow

### Description
Retrieves smart money netflow data for tokens, allowing for sorting and pagination. This endpoint is useful for tracking the flow of funds into and out of tokens by sophisticated investors.

### Method
GET

### Endpoint
/v2/smart_money/netflow

### Parameters
#### Query Parameters
- **sort_by** (SmartMoneyNetflowSortField) - Optional - Field to sort the results by.
- **sort_direction** (SortDirection) - Optional - Direction of sorting (ASC or DESC).
- **chain** (string) - Optional - Filter by blockchain network (e.g., "ethereum", "polygon").
- **sectors** (string) - Optional - Filter by token sectors (e.g., "DeFi", "Infrastructure").
- **min_net_flow_1h_usd** (number) - Optional - Minimum net flow in USD for the past 1 hour.
- **max_net_flow_1h_usd** (number) - Optional - Maximum net flow in USD for the past 1 hour.
- **min_net_flow_24h_usd** (number) - Optional - Minimum net flow in USD for the past 24 hours.
- **max_net_flow_24h_usd** (number) - Optional - Maximum net flow in USD for the past 24 hours.
- **min_net_flow_7d_usd** (number) - Optional - Minimum net flow in USD for the past 7 days.
- **max_net_flow_7d_usd** (number) - Optional - Maximum net flow in USD for the past 7 days.
- **min_net_flow_30d_usd** (number) - Optional - Minimum net flow in USD for the past 30 days.
- **max_net_flow_30d_usd** (number) - Optional - Maximum net flow in USD for the past 30 days.
- **min_trader_count** (integer) - Optional - Minimum number of smart money traders in the past 30 days.
- **max_trader_count** (integer) - Optional - Maximum number of smart money traders in the past 30 days.
- **min_token_age_days** (integer) - Optional - Minimum age of the token in days.
- **max_token_age_days** (integer) - Optional - Maximum age of the token in days.
- **min_market_cap_usd** (number) - Optional - Minimum market cap in USD.
- **max_market_cap_usd** (number) - Optional - Maximum market cap in USD.
- **page** (integer) - Optional - Page number for pagination (defaults to 1).
- **per_page** (integer) - Optional - Number of records per page (defaults to 10, max 1000).

### Request Example
```json
{
  "query": {
    "sort_by": "net_flow_24h_usd",
    "sort_direction": "DESC",
    "chain": "ethereum",
    "sectors": "DeFi",
    "min_net_flow_1h_usd": 1000000,
    "page": 1,
    "per_page": 50
  }
}
```

### Response
#### Success Response (200)
- **data** (array[SmartMoneyNetflow]) - List of smart money netflow records.
- **pagination** (PaginationInfo) - Pagination information.

#### Response Example
```json
{
  "data": [
    {
      "token_address": "0x...",
      "token_symbol": "WETH",
      "net_flow_1h_usd": 5000000.50,
      "net_flow_24h_usd": 20000000.75,
      "net_flow_7d_usd": 75000000.00,
      "net_flow_30d_usd": 150000000.25,
      "chain": "ethereum",
      "token_sectors": ["DeFi", "Infrastructure"],
      "trader_count": 1200,
      "token_age_days": 1825,
      "market_cap_usd": 50000000000.00
    }
    // ... more records
  ],
  "pagination": {
    "page": 1,
    "per_page": 50,
    "is_last_page": false
  }
}
```

### Headers
- **XNansenCreditsUsed** (string) - Number of credits consumed by this API request.
- **XNansenCreditsRemaining** (string) - Total credits remaining in the user's account after this request.
- **RateLimitLimit** (string) - Combined rate limit across all configured time windows.
- **RateLimitRemaining** (string) - Number of requests remaining in the current limiting window.
- **RateLimitReset** (string) - Time in seconds until the rate limit window resets.
- **XRateLimitLimitSecond** (string) - Maximum requests allowed per second.
- **XRateLimitRemainingSecond** (string) - Number of requests remaining in the current second.

```

--------------------------------

### API Endpoints Overview

Source: https://docs.nansen.ai/getting-started/make-your-first-api-call

Provides links to other key API sections within the Nansen AI documentation.

```APIDOC
## API Endpoints Overview

### Description
This section provides links to different API categories available on Nansen.

### Method
N/A (Navigation links)

### Endpoint
N/A (Navigation links)

### Links to Other API Sections:
- **Smart Money:** [../api/smart-money](../api/smart-money)
- **Token God Mode:** [../api/token-god-mode](../api/token-god-mode)
- **Profiler:** [../api/profiler](../api/profiler)
- **Portfolio:** [../api/portfolio](../api/portfolio)

### Additional Resources:
- **Usecase Templates:** [use-case-templates](https://docs.nansen.ai/getting-started/use-case-templates)
```

--------------------------------

### Nansen API Call with cURL

Source: https://docs.nansen.ai/getting-started/make-your-first-api-call

This snippet demonstrates how to make a POST request to the Nansen API's token-screener endpoint using cURL. It includes setting the API key, content type, and a JSON payload with various parameters for filtering and pagination. Ensure you replace 'YOUR_API_KEY' with your actual Nansen API key.

```bash
curl -L \
  --request POST \
  --url 'https://api.nansen.ai/api/v1/token-screener' \
  --header 'apiKey: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{ \
    "chains": [ \
      "ethereum", \
      "solana", \
      "base" \
    ], \
    "date": { \
      "from": "2025-01-01T00:00:00Z", \
      "to": "2025-01-31T23:59:59Z" \
    }, \
    "pagination": { \
      "page": 1, \
      "per_page": 10 \
    }, \
    "filters": { \
      "only_smart_money": true, \
      "token_age_days": { \
        "max": 365, \
        "min": 1 \
      } \
    }, \
    "order_by": [ \
      { \
        "field": "chain", \
        "direction": "ASC" \
      } \
    ] \
  }'
```

--------------------------------

### Get TGM Who Bought/Sold Data - Request Example

Source: https://docs.nansen.ai/api/token-god-mode/who-bought-sold

This JSON snippet demonstrates a typical request payload for the TGM Who Bought/Sold endpoint. It specifies the blockchain, token address, date range, and filters to retrieve aggregated trade volume data for addresses.

```json
{
  "chain": "ethereum",
  "token_address": "0x1f9840a85d5401d1ae23275751736f428d3f4730",
  "buy_or_sell": "BUY",
  "date": {
    "from": "2023-01-01T00:00:00Z",
    "to": "2023-01-31T23:59:59Z"
  },
  "pagination": {
    "per_page": 100
  },
  "filters": {
    "include_smart_money_labels": [
      "30D Smart Trader"
    ],
    "bought_volume_usd": {
      "gt": 10000
    }
  },
  "order_by": [
    {
      "field": "bought_volume_usd",
      "direction": "DESC"
    }
  ]
}
```

--------------------------------

### POST /api/v1/token-screener

Source: https://docs.nansen.ai/getting-started/make-your-first-api-call

Discover and screen tokens across multiple blockchains with advanced filtering capabilities. This endpoint helps identify trending tokens, new launches, and smart money movements by combining metrics like volume, liquidity, market cap, and trading activity.

```APIDOC
## POST /api/v1/token-screener

### Description
Discover and screen tokens across multiple blockchains with advanced filtering capabilities. This endpoint helps identify trending tokens, new launches, and smart money movements by combining metrics like volume, liquidity, market cap, and trading activity.

**What it helps to answer:**

1. **Which tokens are experiencing significant smart money activity across different chains?**
2. **How do market metrics (price, volume, liquidity) correlate with holder behavior and smart money movements?**
3. **What tokens show strong fundamentals in terms of holder distribution and trading patterns?**
4. **Which emerging tokens are attracting fresh wallet inflows while maintaining healthy smart money participation?**

### Method
POST

### Endpoint
/api/v1/token-screener

### Parameters
#### Query Parameters
- **chains** (array of string) - Optional - Comma-separated list of blockchain names to filter results by (e.g., "ethereum,polygon").
- **limit** (integer) - Optional - Maximum number of results to return.
- **offset** (integer) - Optional - Number of results to skip.

#### Request Body
- **price_min** (number) - Optional - Minimum token price.
- **price_max** (number) - Optional - Maximum token সংলাপ
- **market_cap_min** (number) - Optional - Minimum market capitalization.
- **market_cap_max** (number) - Optional - Maximum market capitalization.
- **market_cap_diff_24h_min** (number) - Optional - Minimum change in market capitalization over the last 24 hours.
- **market_cap_diff_24h_max** (number) - Optional - Maximum change in market capitalization over the last 24 hours.
- **volume_min** (number) - Optional - Minimum trading volume over the last 24 hours.
- **volume_max** (number) - Optional - Maximum trading volume over the last 24 hours.
- **volume_diff_24h_min** (number) - Optional - Minimum change in trading volume over the last 24 hours.
- **volume_diff_24h_max** (number) - Optional - Maximum trading volume over the last 24 hours.
- **liquidity_min** (number) - Optional - Minimum liquidity.
- **liquidity_max** (number) - Optional - Maximum liquidity.
- **buy_volume_min** (number) - Optional - Minimum buy volume over the last 24 hours.
- **buy_volume_max** (number) - Optional - Maximum buy volume over the last 24 hours.
- **sell_volume_min** (number) - Optional - Minimum sell volume over the last 24 hours.
- **sell_volume_max** (number) - Optional - Maximum sell volume over the last 24 hours.
- **netflow_min** (number) - Optional - Minimum net flow (buy_volume - sell_volume) over the last 24 hours.
- **netflow_max** (number) - Optional - Maximum net flow (buy_volume - sell_volume) over the last 24 hours.
- **holders_min** (integer) - Optional - Minimum number of holders.
- **holders_max** (integer) - Optional - Maximum number of holders.
- **holders_diff_24h_min** (integer) - Optional - Minimum change in the number of holders over the last 24 hours.
- **holders_diff_24h_max** (integer) - Optional - Maximum change in the number of holders over the last 24 hours.
- **smart_money_buy_volume_min** (number) - Optional - Minimum buy volume from smart money over the last 24 hours.
- **smart_money_buy_volume_max** (number) - Optional - Maximum buy volume from smart money over the last 24 hours.
- **smart_money_sell_volume_min** (number) - Optional - Minimum sell volume from smart money over the last 24 hours.
- **smart_money_sell_volume_max** (number) - Optional - Maximum sell volume from smart money over the last 24 hours.
- **smart_money_netflow_min** (number) - Optional - Minimum net flow from smart money over the last 24 hours.
- **smart_money_netflow_max** (number) - Optional - Maximum net flow from smart money over the last 24 hours.
- **smart_money_address_count_min** (integer) - Optional - Minimum count of smart money addresses.
- **smart_money_address_count_max** (integer) - Optional - Maximum count of smart money addresses.
- **smart_money_address_count_diff_24h_min** (integer) - Optional - Minimum change in the count of smart money addresses over the last 24 hours.
- **smart_money_address_count_diff_24h_max** (integer) - Optional - Maximum change in the count of smart money addresses over the last 24 hours.
- **dex_trades_min** (integer) - Optional - Minimum number of DEX trades over the last 24 hours.
- **dex_trades_max** (integer) - Optional - Maximum number of DEX trades over the last 24 hours.
- **dex_trades_diff_24h_min** (integer) - Optional - Minimum change in DEX trades over the last 24 hours.
- **dex_trades_diff_24h_max** (integer) - Optional - Maximum change in DEX trades over the last 24 hours.
- **dex_traders_min** (integer) - Optional - Minimum number of DEX traders over the last 24 hours.
- **dex_traders_max** (integer) - Optional - Maximum number of DEX traders over the last 24 hours.
- **dex_traders_diff_24h_min** (integer) - Optional - Minimum change in DEX traders over the last 24 hours.
- **dex_traders_diff_24h_max** (integer) - Optional - Maximum change in DEX traders over the last 24 hours.
- **dex_volume_min** (number) - Optional - Minimum DEX trading volume over the last 24 hours.
- **dex_volume_max** (number) - Optional - Maximum DEX trading volume over the last 24 hours.
- **dex_volume_diff_24h_min** (number) - Optional - Minimum change in DEX trading volume over the last 24 hours.
- **dex_volume_diff_24h_max** (number) - Optional - Maximum change in DEX trading volume over the last 24 hours.
- **token_transfer_volume_min** (number) - Optional - Minimum token transfer volume over the last 24 hours.
- **token_transfer_volume_max** (number) - Optional - Maximum token transfer volume over the last 24 hours.
- **token_transfer_volume_diff_24h_min** (number) - Optional - Minimum change in token transfer volume over the last 24 hours.
- **token_transfer_volume_diff_24h_max** (number) - Optional - Maximum change in token transfer volume over the last 24 hours.
- **token_transfer_count_min** (integer) - Optional - Minimum token transfer count over the last 24 hours.
- **token_transfer_count_max** (integer) - Optional - Maximum token transfer count over the last 24 hours.
- **token_transfer_count_diff_24h_min** (integer) - Optional - Minimum change in token transfer count over the last 24 hours.
- **token_transfer_count_diff_24h_max** (integer) - Optional - Maximum change in token transfer count over the last 24 hours.

### Request Example
```json
{
  "chains": ["ethereum", "polygon"],
  "limit": 10,
  "offset": 0,
  "market_cap_min": 1000000,
  "volume_min": 500000,
  "holders_min": 1000,
  "smart_money_netflow_min": 10000
}
```

### Response
#### Success Response (200)
- **tokens** (array) - List of token screening results.
  - **chain** (string) - Blockchain name.
  - **token_address** (string) - Token contract address.
  - **token_symbol** (string) - Token symbol.
  - **price** (number) - Current token price.
  - **market_cap** (number) - Current market capitalization.
  - **volume** (number) - Total trading volume in USD over the last 24 hours.
  - **liquidity** (number) - Total liquidity in USD.
  - **holders** (integer) - Number of token holders.
  - **buy_volume** (number) - Total buy volume in USD over the last 24 hours.
  - **sell_volume** (number) - Total sell volume in USD over the last 24 hours.
  - **netflow** (number) - Net flow (buy_volume - sell_volume) in USD over the last 24 hours.
- **pagination** (object) - Pagination information.
  - **page** (integer) - Current page number.
  - **per_page** (integer) - Number of records per page.
  - **is_last_page** (boolean) - Whether this is the last page.

#### Response Example
```json
{
  "tokens": [
    {
      "chain": "ethereum",
      "token_address": "0x1f9840a85d5401d1ae232c55c22b074719c9d782",
      "token_symbol": "UNI",
      "price": 7.50,
      "market_cap": 1500000000,
      "volume": 300000000,
      "liquidity": 500000000,
      "holders": 200000,
      "buy_volume": 160000000,
      "sell_volume": 140000000,
      "netflow": 20000000
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": false
  }
}
```

### Error Handling
- **400 Bad Request**: Invalid request parameters or malformed request.
- **401 Unauthorized**: No API key found in request.
- **403 Forbidden**: User does not have the required subscription tier or has exceeded the credit limit.
- **404 Not Found**: The requested resource was not found.
- **422 Validation Error**: Invalid request parameters.
- **429 Too Many Requests**: Rate limit exceeded. Includes `retry_after` field in seconds.
- **500 Internal Server Error**: An unexpected error occurred.
```

--------------------------------

### Get Address PnL Summary Data (OpenAPI Schema)

Source: https://docs.nansen.ai/api/profiler/address-pnl-and-trade-performance

This OpenAPI 3.1.0 schema defines the request and response structures for the 'Get Address PnL Summary Data' endpoint. It specifies parameters like address, chain, and date range, and details the response fields such as realized PnL, win rate, and top tokens.

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Nansen API v1",
    "version": "1.0.0"
  },
  "tags": [
    {
      "name": "Profiler",
      "description": "Wallet profiler analysis endpoints"
    }
  ],
  "servers": [
    {
      "url": "https://api.nansen.ai"
    }
  ],
  "security": [
    {
      "ApiKeyAuth": []
    }
  ],
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "apiKey",
        "description": "API key for authentication"
      }
    },
    "schemas": {
      "ProfilerAddressPnlSummaryRequest": {
        "properties": {
          "address": {
            "anyOf": [
              {
                "type": "string"
              }
            ],
            "title": "Address",
            "description": "Address to get PnL summary for"
          },
          "entity_name": {
            "anyOf": [
              {
                "type": "string"
              }
            ],
            "title": "Entity Name",
            "description": "Entity name to get PnL summary for"
          },
          "chain": {
            "$ref": "#/components/schemas/ProfilerPnLChain",
            "description": "Blockchain chain for the PnL data"
          },
          "date": {
            "$ref": "#/components/schemas/DateRange",
            "description": "Date range for the PnL data"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "chain",
          "date"
        ],
        "title": "ProfilerAddressPnlSummaryRequest",
        "description": ""
      },
      "ProfilerPnLChain": {
        "type": "string",
        "enum": [
          "all",
          "arbitrum",
          "avalanche",
          "base",
          "bitcoin",
          "bnb",
          "ethereum",
          "hyperevm",
          "linea",
          "mantle",
          "monad",
          "optimism",
          "plasma",
          "polygon",
          "ronin",
          "scroll",
          "sei",
          "solana",
          "sonic",
          "unichain",
          "zksync"
        ],
        "title": "ProfilerPnLChain",
        "description": "Enum for chains supported in profiler analysis."
      },
      "DateRange": {
        "properties": {
          "from": {
            "anyOf": [
              {
                "type": "string"
              }
            ],
            "title": "From",
            "description": "Start date in ISO 8601 format"
          },
          "to": {
            "anyOf": [
              {
                "type": "string"
              }
            ],
            "title": "To",
            "description": "End date in ISO 8601 format"
          }
        },
        "type": "object",
        "title": "DateRange",
        "description": "Date range model matching the API schema."
      },
      "ProfilerAddressPnlSummaryResponse": {
        "properties": {
          "pagination": {
            "$ref": "#/components/schemas/PaginationInfo",
            "description": "Pagination information"
          },
          "top5_tokens": {
            "items": {
              "$ref": "#/components/schemas/ProfilerTopToken"
            },
            "type": "array",
            "title": "Top5 Tokens",
            "description": "Top 5 tokens by realized profit"
          },
          "traded_token_count": {
            "type": "integer",
            "title": "Traded Token Count",
            "description": "Total number of different tokens that have been bought or sold"
          },
          "traded_times": {
            "type": "integer",
            "title": "Traded Times",
            "description": "Total number of sales (outflow or dex sell)"
          },
          "realized_pnl_usd": {
            "type": "number",
            "title": "Realized Pnl Usd",
            "description": "Total realized profit and loss in USD"
          },
          "realized_pnl_percent": {
            "type": "number",
            "title": "Realized Pnl Percent",
            "description": "Realized profit and loss as a percentage (not multiplied by 100)"
          },
          "win_rate": {
            "type": "number",
            "title": "Win Rate",
            "description": "Number of sales where price of the token was higher than cost basis"
          }
        },
        "type": "object",
        "required": [
          "pagination",
          "top5_tokens",
          "traded_token_count",
          "traded_times",
          "realized_pnl_usd",
          "realized_pnl_percent",
          "win_rate"
        ],
        "title": "ProfilerAddressPnlSummaryResponse",
        "description": "Response model for profiler address pnl-summary endpoint.\n\nContains aggregate PnL statistics and top profitable tokens."
      },
      "PaginationInfo": {
        "properties": {
          "page": {
            "type": "integer",
            "minimum": 1,
            "title": "Page",
            "description": "Current page number",
            "default": 1
          },
          "per_page": {
            "type": "integer",
            "maximum": 1000,
            "minimum": 1,
            "title": "Per Page",
            "description": "Number of records per page",
            "default": 10
          },
          "is_last_page": {
            "type": "boolean",
            "title": "Is Last Page",
            "description": "Whether this is the last page",
            "default": true
          }
        },
        "type": "object",
        "title": "PaginationInfo",
        "description": "Pagination information for API responses."
      },
      "ProfilerTopToken": {
        "properties": {
          "realized_pnl": {
            "anyOf": [
              {
                "type": "number"
              }
            ],
            "title": "Realized Pnl",
            "description": "Realized profit and loss in USD"
          },
          "realized_roi": {
            "anyOf": [
              {
                "type": "number"
              }
            ],
            "title": "Realized Roi",
            "description": "Realized return on investment as percentage"
          },
          "token_address": {
            "type": "string",
            "title": "Token Address",
            "description": "Token contract address"
          },
          "token_symbol": {
            "type": "string",
            "title": "Token Symbol",
            "description": "Token symbol"
          },
          "chain": {
            "type": "string",
            "title": "Chain",
            "description": "Blockchain chain"
          }
        },
        "type": "object",
        "required": [
          "realized_pnl",
          "realized_roi",
          "token_address",
          "token_symbol",
          "chain"
        ],
        "title": "ProfilerTopToken",
        "description": "Individual top token record for PnL summary.\n\nRepresents a top profitable token from the wallet's trading history."
      }
    }
  },
  "headers": {
    "XNansenCreditsUsed": {
      "description": "Number of credits consumed by this API request",
      "schema": {
        "type": "string"
      }
    },
    "XNansenCreditsRemaining": {
      "description": "Total credits remaining in the user's account after this request",
      "schema": {
        "type": "string"
      }
    },
    "RateLimitLimit": {
      "description": "Combined rate limit across all configured time windows",
      "schema": {
        "type": "string"
      }
    },
    "RateLimitRemaining": {
      "description": "Number of requests remaining in the current limiting window",
      "schema": {
        "type": "string"
      }
    },
    "RateLimitReset": {
      "description": "Tim"
    }
  }
}
```

--------------------------------

### Token Screener Filters

Source: https://docs.nansen.ai/getting-started/make-your-first-api-call

This section details the available filters for the token screener API. These filters can be combined to narrow down the token search based on specific criteria such as market capitalization, trading volume, price changes, and smart money activity.

```APIDOC
## Token Screener Filters

### Description
These filters allow you to precisely define the criteria for screening tokens. You can specify ranges for numerical values like market cap, volume, and price, as well as include or exclude specific tokens, sectors, and smart money labels.

### Parameters
#### Query Parameters
- **token_address** (string or array of strings or null) - Optional - Token address or symbol filter.
- **token_symbol** (string or array of strings or null) - Optional - Token symbol filter.
- **only_smart_money** (boolean) - Optional - Whether to only include smart money tokens (default: false).
- **sectors** (array of strings) - Optional - Token sectors to include.
- **token_age_days** (NumericRangeFilter) - Optional - Token age range filter in days.
- **market_cap_usd** (NumericRangeFilter) - Optional - Market cap range filter.
- **liquidity** (NumericRangeFilter) - Optional - Liquidity range filter.
- **price_usd** (NumericRangeFilter) - Optional - Current price range filter in USD.
- **price_change** (NumericRangeFilter) - Optional - Price change percentage range filter.
- **fdv** (NumericRangeFilter) - Optional - Fully Diluted Valuation range filter.
- **fdv_mc_ratio** (NumericRangeFilter) - Optional - FDV to Market Cap ratio range filter.
- **nof_buyers** (IntegerRangeFilter) - Optional - Number of unique buyers range filter.
- **nof_traders** (IntegerRangeFilter) - Optional - Number of unique traders range filter.
- **nof_sellers** (IntegerRangeFilter) - Optional - Number of unique sellers range filter.
- **nof_buys** (IntegerRangeFilter) - Optional - Number of buy transactions range filter.
- **nof_sells** (IntegerRangeFilter) - Optional - Number of sell transactions range filter.
- **buy_volume** (NumericRangeFilter) - Optional - Buy volume range filter in USD.
- **sell_volume** (NumericRangeFilter) - Optional - Sell volume range filter in USD.
- **volume** (NumericRangeFilter) - Optional - Total trading volume range filter in USD.
- **netflow** (NumericRangeFilter) - Optional - Net flow range filter in USD.
- **inflow_fdv_ratio** (NumericRangeFilter) - Optional - Inflow to FDV ratio range filter.
- **outflow_fdv_ratio** (NumericRangeFilter) - Optional - Outflow to FDV ratio range filter.
- **include_smart_money_labels** (array of SmartMoneyFilterType) - Optional - Include smart money labels.
- **exclude_smart_money_labels** (array of SmartMoneyFilterType) - Optional - Exclude smart money labels.

### Filter Definitions
#### NumericRangeFilter
- **min** (number) - Optional - Minimum value (inclusive).
- **max** (number) - Optional - Maximum value (inclusive).

#### IntegerRangeFilter
- **min** (integer) - Optional - Minimum value (inclusive).
- **max** (integer) - Optional - Maximum value (inclusive).

#### SmartMoneyFilterType
(string) - Enum: "Fund", "Smart Trader", "30D Smart Trader", "90D Smart Trader", "180D Smart Trader", "Smart HL Perps Trader"

### Example Usage (Conceptual)
GET /tokens/screen?market_cap_usd.min=100000000&price_change.min=-5&sectors=DeFi

```

--------------------------------

### Get Portfolio DeFi Holdings Data

Source: https://docs.nansen.ai/api/portfolio

Fetches aggregated DeFi holdings for a specified wallet address, presenting a clear summary of tokens and protocols.

```APIDOC
## POST /v1/balances/portfolio/defi

### Description
Get simplified DeFi holdings for a wallet address with aggregated tokens and protocol summaries in a user-friendly format.

### Method
POST

### Endpoint
https://api.nansen.ai/v1/balances/portfolio/defi

### Parameters
#### Request Body
- **wallet_address** (string) - Required - Wallet address to get DeFi holdings for

### Request Example
```json
{
  "wallet_address": "0x1234567890abcdef1234567890abcdef12345678"
}
```

### Response
#### Success Response (200)
- **summary** (object) - Overall portfolio summary
  - **total_value_usd** (number) - Total USD value of all holdings
  - **total_assets_usd** (number) - Total USD value of all assets
  - **total_debts_usd** (number) - Total USD value of all debts
  - **total_rewards_usd** (number) - Total USD value of all rewards
  - **token_count** (integer) - Total number of unique tokens
  - **protocol_count** (integer) - Total number of protocols
- **protocols** (array) - Protocol-specific holdings with token breakdown
  - **protocol_name** (string) - User-friendly protocol name
  - **chain** (string) - Blockchain network
  - **total_value_usd** (number) - Total USD value in this protocol
  - **total_assets_usd** (number) - Total USD value of assets in this protocol
  - **total_debts_usd** (number) - Total USD value of debts in this protocol
  - **total_rewards_usd** (number) - Total USD value of rewards in this protocol
  - **tokens** (array) - Token holdings in this protocol
    - **address** (string) - Token contract address (null for native tokens)
    - **symbol** (string) - Token symbol
    - **amount** (number) - Token amount
    - **value_usd** (number) - USD value
    - **position_type** (string) - Position type: deposit, stake, borrow, or mixed

#### Response Example
```json
{
  "summary": {
    "total_value_usd": 15000.75,
    "total_assets_usd": 16000.50,
    "total_debts_usd": 999.75,
    "total_rewards_usd": 0.00,
    "token_count": 15,
    "protocol_count": 3
  },
  "protocols": [
    {
      "protocol_name": "Uniswap",
      "chain": "Ethereum",
      "total_value_usd": 10000.50,
      "total_assets_usd": 10500.00,
      "total_debts_usd": 499.50,
      "total_rewards_usd": 0.00,
      "tokens": [
        {
          "address": "0x1f9840a85d5af5bf1d1762f925bdaddc4201f984",
          "symbol": "UNI",
          "amount": 500.00,
          "value_usd": 4000.00,
          "position_type": "deposit"
        },
        {
          "address": "0xdAC17F95823f0E1B033CF371190d93563A943287",
          "symbol": "USDT",
          "amount": 6500.50,
          "value_usd": 6500.50,
          "position_type": "deposit"
        }
      ]
    },
    {
      "protocol_name": "Aave",
      "chain": "Ethereum",
      "total_value_usd": 5000.25,
      "total_assets_usd": 5500.50,
      "total_debts_usd": 500.25,
      "total_rewards_usd": 0.00,
      "tokens": [
        {
          "address": "0x2b530b3bff181ab537059201f0994b0628019a6f",
          "symbol": "WBTC",
          "amount": 0.25,
          "value_usd": 5000.25,
          "position_type": "deposit"
        }
      ]
    }
  ]
}
```
```
Tokens:
Raw