# Token Screener

{% hint style="info" %}
**Data Retention Limits**

This endpoint only supports recent data:

* Minute Granularity: Last 130 minutes 
* Hourly Granularity: Last 50 hours
* Daily Granularity: Last 50 days

**Historical Analysis Not Supported:**

* `to_date` must be within 5 minutes of current time
* Historical snapshots (e.g., "show me January 2024") are not available
  {% endhint %}

## Get Token Screening Data

> 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?\*\*

```json
{"openapi":"3.1.0","info":{"title":"Nansen API","version":"1.0.0"},"servers":[{"url":"https://api.nansen.ai"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"apiKey","description":"API key for authentication"}},"schemas":{"TokenScreenerRequest":{"properties":{"chains":{"items":{"$ref":"#/components/schemas/TokenScreenerChain"},"type":"array","maxItems":5,"minItems":1,"title":"Chains","description":"List of blockchain chains to filter by"},"timeframe":{"anyOf":[{"$ref":"#/components/schemas/TokenScreenerTimeframe"}],"description":"**Required** (unless using deprecated 'date' parameter).\n\nTime window for token screening data.\n\nAvailable timeframes and their data characteristics:\n- 5m: Last 5 minutes (minute-level granularity, 2-hour retention)\n- 10m: Last 10 minutes (minute-level granularity, 2-hour retention)\n- 1h: Last 1 hour (minute-level granularity, 2-hour retention)\n- 6h: Last 6 hours (hourly granularity, 2-day retention)\n- 24h: Last 24 hours (hourly granularity, 2-day retention)\n- 7d: Last 7 days (daily granularity, 2-month retention)\n- 30d: Last 30 days (daily granularity, 2-month retention)\n\nCannot be used together with 'date'."},"date":{"anyOf":[{"$ref":"#/components/schemas/DateRange"}],"description":"**DEPRECATED**: Use 'timeframe' instead for better reliability and performance.\n\nRequired only if 'timeframe' is not provided.\n\nCustom date range for the token screener. The granularity is automatically determined from the date range:\n- ≤ 1 hour: minute-level data (limited to last 2 hours)\n- > 1 hour to 1 day: hourly data (limited to last 2 days)\n- > 1 day: daily data (limited to last 2 months)\n\nCannot be used together with 'timeframe'.","deprecated":true},"pagination":{"$ref":"#/components/schemas/PaginationRequest","description":"Pagination parameters"},"filters":{"anyOf":[{"$ref":"#/components/schemas/TokenScreenerFilters"}],"description":"Additional filters to apply"},"order_by":{"anyOf":[{"items":{"$ref":"#/components/schemas/SortOrder_TokenScreenerSortField_"},"type":"array"}],"title":"Order By","description":"Custom sort order to override the endpoint's default ordering.\n\nExamples:\n- [{\"field\": \"buy_volume\", \"direction\": \"DESC\"}] - Sort by buy volume descending\n- [{\"field\": \"price_change\", \"direction\": \"DESC\"}] - Sort by price change descending"}},"additionalProperties":false,"type":"object","required":["chains"],"title":"TokenScreenerRequest","description":"Request model for Token Screener endpoint.\n\nEither 'timeframe' (recommended) or 'date' (deprecated) must be provided."},"TokenScreenerChain":{"type":"string","enum":["arbitrum","avalanche","base","bitcoin","bnb","ethereum","hyperevm","injective","iotaevm","linea","mantle","monad","near","optimism","plasma","polygon","ronin","scroll","sei","solana","sonic","starknet","sui","ton","tron"],"title":"TokenScreenerChain","description":"Chains supported for Token Screener endpoint."},"TokenScreenerTimeframe":{"type":"string","enum":["5m","10m","1h","6h","24h","7d","30d"],"title":"TokenScreenerTimeframe","description":"Token screener timeframe options.\n\nDefines the time window for token screening data.\nEach timeframe corresponds to different data granularity and retention periods.\nMatches the timeframe options in the Superapp token-screener widget."},"DateRange":{"properties":{"from":{"anyOf":[{"type":"string"}],"title":"From","description":"Start date in ISO 8601 format (e.g., 2025-01-01T00:00:00Z or 2025-01-01)"},"to":{"anyOf":[{"type":"string"}],"title":"To","description":"End date in ISO 8601 format (e.g., 2025-01-31T23:59:59Z or 2025-01-31)"}},"type":"object","title":"DateRange","description":"Date range model matching the API schema."},"PaginationRequest":{"properties":{"page":{"type":"integer","minimum":1,"title":"Page","description":"Page number (1-based)","default":1},"per_page":{"type":"integer","maximum":1000,"minimum":1,"title":"Per Page","description":"Number of records per page (max 1000)","default":10}},"type":"object","title":"PaginationRequest","description":"Pagination parameters for API requests."},"TokenScreenerFilters":{"properties":{"token_address":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Token Address","description":"Token address or symbol filter"},"token_symbol":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Token Symbol","description":"Token symbol filter"},"only_smart_money":{"anyOf":[{"type":"boolean"}],"title":"Only Smart Money","description":"Deprecated: use trader_type instead. Whether to only include smart money tokens","deprecated":true},"trader_type":{"anyOf":[{"$ref":"#/components/schemas/TraderType"}],"description":"Filter by trader type. Overrides only_smart_money when provided."},"sectors":{"anyOf":[{"items":{"type":"string"},"type":"array"}],"title":"Sectors","description":"Token sectors to include"},"token_age_days":{"anyOf":[{"$ref":"#/components/schemas/NumericRangeFilter"}],"description":"Token age range filter in days"},"market_cap_usd":{"anyOf":[{"$ref":"#/components/schemas/NumericRangeFilter"}],"description":"Market cap range filter"},"liquidity":{"anyOf":[{"$ref":"#/components/schemas/NumericRangeFilter"}],"description":"Liquidity range filter"},"price_usd":{"anyOf":[{"$ref":"#/components/schemas/NumericRangeFilter"}],"description":"Current price range filter in USD"},"price_change":{"anyOf":[{"$ref":"#/components/schemas/NumericRangeFilter"}],"description":"Price change percentage range filter"},"fdv":{"anyOf":[{"$ref":"#/components/schemas/NumericRangeFilter"}],"description":"Fully Diluted Valuation range filter"},"fdv_mc_ratio":{"anyOf":[{"$ref":"#/components/schemas/NumericRangeFilter"}],"description":"FDV to Market Cap ratio range filter"},"nof_buyers":{"anyOf":[{"$ref":"#/components/schemas/IntegerRangeFilter"}],"description":"Number of unique buyers range filter"},"nof_traders":{"anyOf":[{"$ref":"#/components/schemas/IntegerRangeFilter"}],"description":"Number of unique traders range filter"},"nof_sellers":{"anyOf":[{"$ref":"#/components/schemas/IntegerRangeFilter"}],"description":"Number of unique sellers range filter"},"nof_buys":{"anyOf":[{"$ref":"#/components/schemas/IntegerRangeFilter"}],"description":"Number of buy transactions range filter"},"nof_sells":{"anyOf":[{"$ref":"#/components/schemas/IntegerRangeFilter"}],"description":"Number of sell transactions range filter"},"buy_volume":{"anyOf":[{"$ref":"#/components/schemas/NumericRangeFilter"}],"description":"Buy volume range filter in USD"},"sell_volume":{"anyOf":[{"$ref":"#/components/schemas/NumericRangeFilter"}],"description":"Sell volume range filter in USD"},"volume":{"anyOf":[{"$ref":"#/components/schemas/NumericRangeFilter"}],"description":"Total trading volume range filter in USD"},"netflow":{"anyOf":[{"$ref":"#/components/schemas/NumericRangeFilter"}],"description":"Net flow range filter in USD"},"inflow_fdv_ratio":{"anyOf":[{"$ref":"#/components/schemas/NumericRangeFilter"}],"description":"Inflow to FDV ratio range filter"},"outflow_fdv_ratio":{"anyOf":[{"$ref":"#/components/schemas/NumericRangeFilter"}],"description":"Outflow to FDV ratio range filter"},"include_stablecoins":{"type":"boolean","title":"Include Stablecoins","description":"Whether to include stablecoins in token screener results. Default true preserves current behavior. Set to false to exclude USDC, USDT, DAI, and other major stablecoins.","default":true},"include_smart_money_labels":{"anyOf":[{"items":{"$ref":"#/components/schemas/SmartMoneyFilterType"},"type":"array"}],"title":"Include Smart Money Labels","description":"Include smart money labels"},"exclude_smart_money_labels":{"anyOf":[{"items":{"$ref":"#/components/schemas/SmartMoneyFilterType"},"type":"array"}],"title":"Exclude Smart Money Labels","description":"Exclude smart money labels"}},"additionalProperties":false,"type":"object","title":"TokenScreenerFilters","description":"Filters for token screener endpoints.\n\nThese filters control which tokens are included in the screening\nresults based on various criteria."},"TraderType":{"type":"string","enum":["all","sm","whale","public_figure"],"title":"TraderType","description":"Trader type filter for token screener."},"NumericRangeFilter":{"properties":{"min":{"anyOf":[{"type":"number"}],"title":"Min","description":"Minimum value (inclusive)"},"max":{"anyOf":[{"type":"number"}],"title":"Max","description":"Maximum value (inclusive)"}},"type":"object","title":"NumericRangeFilter","description":"Filter for numeric values (floats) with optional min/max bounds.\nUse for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75"},"IntegerRangeFilter":{"properties":{"min":{"anyOf":[{"type":"integer"}],"title":"Min","description":"Minimum value (inclusive)"},"max":{"anyOf":[{"type":"integer"}],"title":"Max","description":"Maximum value (inclusive)"}},"type":"object","title":"IntegerRangeFilter","description":"Filter for integer values with optional min/max bounds.\nUse for counts, numbers of items, and other whole number values. - Values between 5 and 100"},"SmartMoneyFilterType":{"type":"string","enum":["Fund","Smart Trader","30D Smart Trader","90D Smart Trader","180D Smart Trader","Smart HL Perps Trader"],"title":"SmartMoneyFilterType","description":"Enum for smart money filter options."},"SortOrder_TokenScreenerSortField_":{"properties":{"field":{"$ref":"#/components/schemas/TokenScreenerSortField","description":"Field to sort by"},"direction":{"$ref":"#/components/schemas/SortDirection","description":"Sort direction (ASC or DESC)"}},"type":"object","required":["field","direction"],"title":"SortOrder[TokenScreenerSortField]"},"TokenScreenerSortField":{"type":"string","enum":["chain","token_address","token_symbol","market_cap_usd","volume","liquidity","nof_traders","nof_buyers","nof_sellers","nof_buys","nof_sells","price_change","price_usd","netflow","buy_volume","sell_volume"],"title":"TokenScreenerSortField","description":"Enum for sortable fields in token screener."},"SortDirection":{"type":"string","enum":["ASC","DESC"],"title":"SortDirection","description":"Enum for sort directions."},"TokenScreenerResponse":{"properties":{"data":{"items":{"anyOf":[{"$ref":"#/components/schemas/TokenScreenerDataDefault"},{"$ref":"#/components/schemas/TokenScreenerDataSmartMoneyDefault"},{"$ref":"#/components/schemas/TokenScreenerDataNonDefault"}]},"type":"array","title":"Data","description":"List of token screening results"},"pagination":{"$ref":"#/components/schemas/PaginationInfo","description":"Pagination information"}},"type":"object","required":["data","pagination"],"title":"TokenScreenerResponse","description":"Response model for token screener endpoint."},"TokenScreenerDataDefault":{"properties":{"chain":{"type":"string","title":"Chain","description":"The blockchain network on which the token is deployed."},"token_address":{"type":"string","title":"Token Address","description":"Address of token"},"token_symbol":{"type":"string","title":"Token Symbol","description":"The symbol of the token."},"token_age_days":{"anyOf":[{"type":"number"}],"title":"Token Age Days","description":"Number of days since token deployment."},"market_cap_usd":{"anyOf":[{"type":"number"}],"title":"Market Cap Usd","description":"Market capitalization in USD."},"liquidity":{"anyOf":[{"type":"number"}],"title":"Liquidity","description":"Total on-chain liquidity in USD."},"price_usd":{"anyOf":[{"type":"number"}],"title":"Price Usd","description":"Price of the token"},"price_change":{"anyOf":[{"type":"number"}],"title":"Price Change","description":"Price change percentage from the previous period."},"fdv":{"anyOf":[{"type":"number"}],"title":"Fdv","description":"Fully Diluted Valuation in USD."},"fdv_mc_ratio":{"anyOf":[{"type":"number"}],"title":"Fdv Mc Ratio","description":"Ratio of Fully Diluted Valuation to Market Cap."},"buy_volume":{"anyOf":[{"type":"number"}],"title":"Buy Volume","description":"Total buy volume in USD."},"inflow_fdv_ratio":{"anyOf":[{"type":"number"}],"title":"Inflow Fdv Ratio","description":"Ratio of inflow to Fully Diluted Valuation."},"outflow_fdv_ratio":{"anyOf":[{"type":"number"}],"title":"Outflow Fdv Ratio","description":"Ratio of outflow to Fully Diluted Valuation."},"sell_volume":{"anyOf":[{"type":"number"}],"title":"Sell Volume","description":"Total sell volume in USD."},"volume":{"anyOf":[{"type":"number"}],"title":"Volume","description":"Total trading volume in USD."},"netflow":{"anyOf":[{"type":"number"}],"title":"Netflow","description":"Net flow (buy_volume - sell_volume) in USD."}},"type":"object","required":["chain","token_address","token_symbol"],"title":"TokenScreenerDataDefault","description":"Data model for token screener results with non-default query (excludes trader-related columns)."},"TokenScreenerDataSmartMoneyDefault":{"properties":{"chain":{"type":"string","title":"Chain","description":"The blockchain network on which the token is deployed."},"token_address":{"type":"string","title":"Token Address","description":"Address of token"},"token_symbol":{"type":"string","title":"Token Symbol","description":"The symbol of the token."},"token_age_days":{"anyOf":[{"type":"number"}],"title":"Token Age Days","description":"Number of days since token deployment."},"market_cap_usd":{"anyOf":[{"type":"number"}],"title":"Market Cap Usd","description":"Market capitalization in USD."},"liquidity":{"anyOf":[{"type":"number"}],"title":"Liquidity","description":"Total on-chain liquidity in USD."},"price_usd":{"anyOf":[{"type":"number"}],"title":"Price Usd","description":"Price of the token"},"price_change":{"anyOf":[{"type":"number"}],"title":"Price Change","description":"Price change percentage from the previous period."},"fdv":{"anyOf":[{"type":"number"}],"title":"Fdv","description":"Fully Diluted Valuation in USD."},"fdv_mc_ratio":{"anyOf":[{"type":"number"}],"title":"Fdv Mc Ratio","description":"Ratio of Fully Diluted Valuation to Market Cap."},"nof_traders":{"anyOf":[{"type":"integer"}],"title":"Nof Traders","description":"Total number of unique traders."},"buy_volume":{"anyOf":[{"type":"number"}],"title":"Buy Volume","description":"Total buy volume in USD."},"inflow_fdv_ratio":{"anyOf":[{"type":"number"}],"title":"Inflow Fdv Ratio","description":"Ratio of inflow to Fully Diluted Valuation."},"outflow_fdv_ratio":{"anyOf":[{"type":"number"}],"title":"Outflow Fdv Ratio","description":"Ratio of outflow to Fully Diluted Valuation."},"sell_volume":{"anyOf":[{"type":"number"}],"title":"Sell Volume","description":"Total sell volume in USD."},"volume":{"anyOf":[{"type":"number"}],"title":"Volume","description":"Total trading volume in USD."},"netflow":{"anyOf":[{"type":"number"}],"title":"Netflow","description":"Net flow (buy_volume - sell_volume) in USD."}},"type":"object","required":["chain","token_address","token_symbol"],"title":"TokenScreenerDataSmartMoneyDefault","description":"Data model for smart money token screener with default query.\n\nIncludes nof_traders but excludes other trader-related columns\n(nof_buyers, nof_sellers, nof_buys, nof_sells)."},"TokenScreenerDataNonDefault":{"properties":{"chain":{"type":"string","title":"Chain","description":"The blockchain network on which the token is deployed."},"token_address":{"type":"string","title":"Token Address","description":"Address of token"},"token_symbol":{"type":"string","title":"Token Symbol","description":"The symbol of the token."},"token_age_days":{"anyOf":[{"type":"number"}],"title":"Token Age Days","description":"Number of days since token deployment."},"market_cap_usd":{"anyOf":[{"type":"number"}],"title":"Market Cap Usd","description":"Market capitalization in USD."},"liquidity":{"anyOf":[{"type":"number"}],"title":"Liquidity","description":"Total on-chain liquidity in USD."},"price_usd":{"anyOf":[{"type":"number"}],"title":"Price Usd","description":"Price of the token"},"price_change":{"anyOf":[{"type":"number"}],"title":"Price Change","description":"Price change percentage from the previous period."},"fdv":{"anyOf":[{"type":"number"}],"title":"Fdv","description":"Fully Diluted Valuation in USD."},"fdv_mc_ratio":{"anyOf":[{"type":"number"}],"title":"Fdv Mc Ratio","description":"Ratio of Fully Diluted Valuation to Market Cap."},"nof_buyers":{"anyOf":[{"type":"integer"}],"title":"Nof Buyers","description":"Number of unique buyers."},"nof_traders":{"anyOf":[{"type":"integer"}],"title":"Nof Traders","description":"Total number of unique traders."},"nof_sellers":{"anyOf":[{"type":"integer"}],"title":"Nof Sellers","description":"Number of unique sellers."},"nof_buys":{"anyOf":[{"type":"integer"}],"title":"Nof Buys","description":"Total number of buy transactions."},"nof_sells":{"anyOf":[{"type":"integer"}],"title":"Nof Sells","description":"Total number of sell transactions."},"buy_volume":{"anyOf":[{"type":"number"}],"title":"Buy Volume","description":"Total buy volume in USD."},"inflow_fdv_ratio":{"anyOf":[{"type":"number"}],"title":"Inflow Fdv Ratio","description":"Ratio of inflow to Fully Diluted Valuation."},"outflow_fdv_ratio":{"anyOf":[{"type":"number"}],"title":"Outflow Fdv Ratio","description":"Ratio of outflow to Fully Diluted Valuation."},"sell_volume":{"anyOf":[{"type":"number"}],"title":"Sell Volume","description":"Total sell volume in USD."},"volume":{"anyOf":[{"type":"number"}],"title":"Volume","description":"Total trading volume in USD."},"netflow":{"anyOf":[{"type":"number"}],"title":"Netflow","description":"Net flow (buy_volume - sell_volume) in USD."}},"type":"object","required":["chain","token_address","token_symbol"],"title":"TokenScreenerDataNonDefault","description":"Data model for token screener results with non-default query (includes all columns)."},"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."}},"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"}},"PaymentReceipt":{"description":"Base64url-encoded MPP receipt returned on successful paid requests via Authorization: Payment","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":"Time in seconds until the rate limit window resets","schema":{"type":"string"}},"XRateLimitLimitSecond":{"description":"Maximum requests allowed per second","schema":{"type":"string"}},"XRateLimitRemainingSecond":{"description":"Requests remaining in the current second","schema":{"type":"string"}},"XRateLimitLimitMinute":{"description":"Maximum requests allowed per minute","schema":{"type":"string"}},"XRateLimitRemainingMinute":{"description":"Requests remaining in the current minute","schema":{"type":"string"}},"PaymentRequired":{"description":"Base64-encoded x402 payment options returned on 402 responses for x402 clients","schema":{"type":"string"}},"WWWAuthenticatePayment":{"description":"MPP payment challenge returned on 402 responses, for example `Payment id=\"...\", realm=\"api.nansen.ai\", method=\"tempo\", intent=\"charge\", request=\"...\"`","schema":{"type":"string"}},"RetryAfter":{"description":"Number of seconds to wait before making a new request","schema":{"type":"string"}}},"responses":{"BadRequestError":{"description":"Bad Request - Invalid request parameters or malformed request","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"UnauthorizedError":{"description":"Authentication error - No API key found in request","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"PaymentRequiredError":{"description":"Payment Required - This endpoint supports pay-per-request via x402 and MPP. x402 responses advertise payment options in `Payment-Required`; MPP responses advertise a fresh `WWW-Authenticate: Payment ...` challenge. Successful MPP responses may include `Payment-Receipt`.","headers":{"Payment-Required":{"$ref":"#/components/headers/PaymentRequired"},"WWW-Authenticate":{"$ref":"#/components/headers/WWWAuthenticatePayment"}},"content":{"application/json":{"schema":{"type":"object","description":"Problem-details body for x402 or MPP payment challenges."}}}},"ForbiddenError":{"description":"Forbidden - User does not have required subscription tier or has exceeded credit limit","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"NotFoundError":{"description":"Not Found - The requested resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"ValidationError":{"description":"Validation error - Invalid request parameters","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"array","items":{"type":"object","properties":{"loc":{"type":"array","items":{"type":"string"}},"msg":{"type":"string"},"type":{"type":"string"}}}}}}}}},"TooManyRequestsError":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"},"retry_after":{"type":"integer","description":"Seconds to wait before retrying"}}}}},"headers":{"Retry-After":{"$ref":"#/components/headers/RetryAfter"}}},"InternalServerError":{"description":"Internal Server Error - An unexpected error occurred","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}},"paths":{"/api/v1/token-screener":{"post":{"tags":["Token Screener"],"summary":"Get Token Screening Data","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.\n\n**What it helps to answer:**\n\n1. **Which tokens are experiencing significant smart money activity across different chains?**\n2. **How do market metrics (price, volume, liquidity) correlate with holder behavior and smart money movements?**\n3. **What tokens show strong fundamentals in terms of holder distribution and trading patterns?**\n4. **Which emerging tokens are attracting fresh wallet inflows while maintaining healthy smart money participation?**","operationId":"get_token_screener_api_v1_token_screener_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenScreenerRequest"}}},"required":true},"responses":{"200":{"description":"Token screening data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenScreenerResponse"}}},"headers":{"X-Nansen-Credits-Used":{"$ref":"#/components/headers/XNansenCreditsUsed"},"X-Nansen-Credits-Remaining":{"$ref":"#/components/headers/XNansenCreditsRemaining"},"Payment-Receipt":{"$ref":"#/components/headers/PaymentReceipt"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RateLimit-Limit-Second":{"$ref":"#/components/headers/XRateLimitLimitSecond"},"X-RateLimit-Remaining-Second":{"$ref":"#/components/headers/XRateLimitRemainingSecond"},"X-RateLimit-Limit-Minute":{"$ref":"#/components/headers/XRateLimitLimitMinute"},"X-RateLimit-Remaining-Minute":{"$ref":"#/components/headers/XRateLimitRemainingMinute"}}},"400":{"description":"Bad Request","$ref":"#/components/responses/BadRequestError"},"401":{"description":"Unauthorized","$ref":"#/components/responses/UnauthorizedError"},"402":{"description":"Payment Required","$ref":"#/components/responses/PaymentRequiredError"},"403":{"description":"Forbidden","$ref":"#/components/responses/ForbiddenError"},"404":{"description":"Not Found","$ref":"#/components/responses/NotFoundError"},"422":{"description":"Unprocessable Content","$ref":"#/components/responses/ValidationError"},"429":{"description":"Too Many Requests","$ref":"#/components/responses/TooManyRequestsError"},"500":{"description":"Internal Server Error","$ref":"#/components/responses/InternalServerError"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nansen.ai/api/token-god-mode/token-screener.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.