import {z} from 'zod' export type TokenScreenerChain = 'arbitrum' | 'avalanche' | 'base' | 'bitcoin' | 'bnb' | 'citrea' | 'ethereum' | 'hyperevm' | 'injective' | 'iotaevm' | 'linea' | 'mantle' | 'mantra' | 'monad' | 'near' | 'optimism' | 'plasma' | 'polygon' | 'robinhood' | 'sei' | 'solana' | 'sonic' | 'starknet' | 'sui' | 'ton' | 'tron'; export type TokenScreenerTimeframe = '5m' | '10m' | '1h' | '6h' | '24h' | '7d' | '30d'; export type DateRange = {from?: string | undefined, to?: string | undefined}; export type PaginationRequest = {page?: number | undefined, per_page?: number | undefined}; export type TraderType = 'all' | 'sm' | 'whale' | 'public_figure' | 'trending' | 'consistent_perps_winner' | 'high_winrate_hl_perps_trader' | 'predicted_winner'; export type NumericRangeFilter = {min?: number | undefined, max?: number | undefined}; export type IntegerRangeFilter = {min?: number | undefined, max?: number | undefined}; export type SmartMoneyFilterType = 'Fund' | 'Smart Trader' | '30D Smart Trader' | '90D Smart Trader' | '180D Smart Trader' | 'Smart HL Perps Trader'; export type TokenScreenerFilters = {token_address?: (string | Array | null) | undefined, token_symbol?: (string | Array | null) | undefined, only_smart_money?: boolean | undefined, trader_type?: TraderType | undefined, sectors?: Array | undefined, exclude_sectors?: Array | undefined, token_age_days?: NumericRangeFilter | undefined, market_cap_usd?: NumericRangeFilter | undefined, liquidity?: NumericRangeFilter | undefined, price_usd?: NumericRangeFilter | undefined, price_change?: NumericRangeFilter | undefined, fdv?: NumericRangeFilter | undefined, fdv_mc_ratio?: NumericRangeFilter | undefined, nof_buyers?: IntegerRangeFilter | undefined, nof_traders?: IntegerRangeFilter | undefined, nof_sellers?: IntegerRangeFilter | undefined, nof_buys?: IntegerRangeFilter | undefined, nof_sells?: IntegerRangeFilter | undefined, buy_volume?: NumericRangeFilter | undefined, sell_volume?: NumericRangeFilter | undefined, volume?: NumericRangeFilter | undefined, netflow?: NumericRangeFilter | undefined, inflow_fdv_ratio?: NumericRangeFilter | undefined, outflow_fdv_ratio?: NumericRangeFilter | undefined, include_stablecoins?: boolean | undefined, include_smart_money_labels?: Array | undefined, exclude_smart_money_labels?: Array | undefined}; export type TokenScreenerSortField = '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' | 'fdv' | 'fdv_mc_ratio' | 'inflow_fdv_ratio' | 'outflow_fdv_ratio' | 'token_age_days'; export type SortDirection = 'ASC' | 'DESC'; export type SortOrderTokenScreenerSortField = {field: TokenScreenerSortField, direction: SortDirection}; export type TokenScreenerRequest = {chains: Array, timeframe?: TokenScreenerTimeframe | undefined, date?: DateRange | undefined, pagination?: PaginationRequest | undefined, filters?: TokenScreenerFilters | undefined, order_by?: Array | undefined}; export type CreateApiApiV1TokenScreenerArgs = {body: TokenScreenerRequest}; export type CreateApiApiV1TokenScreenerOptions = {baseUrl?: string | undefined, ApiKeyAuth?: string | undefined, fetch?: typeof fetch | undefined}; export const tokenScreenerDataDefault = z.object({chain: z.string(), token_address: z.string(), token_symbol: z.string(), token_age_days: z.number().optional(), token_age_hours: z.number().optional(), token_deployment_date: z.string().optional(), market_cap_usd: z.number().optional(), liquidity: z.number().optional(), price_usd: z.number().optional(), price_change: z.number().optional(), fdv: z.number().optional(), fdv_mc_ratio: z.number().optional(), buy_volume: z.number().optional(), inflow_fdv_ratio: z.number().optional(), outflow_fdv_ratio: z.number().optional(), sell_volume: z.number().optional(), volume: z.number().optional(), netflow: z.number().optional()}); export const tokenScreenerDataSmartMoneyDefault = z.object({chain: z.string(), token_address: z.string(), token_symbol: z.string(), token_age_days: z.number().optional(), token_age_hours: z.number().optional(), token_deployment_date: z.string().optional(), market_cap_usd: z.number().optional(), liquidity: z.number().optional(), price_usd: z.number().optional(), price_change: z.number().optional(), fdv: z.number().optional(), fdv_mc_ratio: z.number().optional(), nof_traders: z.number().int().optional(), buy_volume: z.number().optional(), inflow_fdv_ratio: z.number().optional(), outflow_fdv_ratio: z.number().optional(), sell_volume: z.number().optional(), volume: z.number().optional(), netflow: z.number().optional()}); export const tokenScreenerDataNonDefault = z.object({chain: z.string(), token_address: z.string(), token_symbol: z.string(), token_age_days: z.number().optional(), token_age_hours: z.number().optional(), token_deployment_date: z.string().optional(), market_cap_usd: z.number().optional(), liquidity: z.number().optional(), price_usd: z.number().optional(), price_change: z.number().optional(), fdv: z.number().optional(), fdv_mc_ratio: z.number().optional(), nof_buyers: z.number().int().optional(), nof_traders: z.number().int().optional(), nof_sellers: z.number().int().optional(), nof_buys: z.number().int().optional(), nof_sells: z.number().int().optional(), buy_volume: z.number().optional(), inflow_fdv_ratio: z.number().optional(), outflow_fdv_ratio: z.number().optional(), sell_volume: z.number().optional(), volume: z.number().optional(), netflow: z.number().optional()}); export const paginationInfo = z.object({page: z.number().int().gte(1).optional(), per_page: z.number().int().gte(1).lte(1000).optional(), is_last_page: z.boolean().optional()}); export const tokenScreenerResponse = z.object({data: z.array(z.union([tokenScreenerDataDefault, tokenScreenerDataSmartMoneyDefault, tokenScreenerDataNonDefault])), pagination: paginationInfo}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * Retrieve token screener data * * POST /api/v1/token-screener */ export const createApiApiV1TokenScreener = async (args: CreateApiApiV1TokenScreenerArgs, options?: CreateApiApiV1TokenScreenerOptions) => { const {baseUrl = "https://api.nansen.ai", fetch: fetchFn = fetch, ApiKeyAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('content-type', "application/json") headers.set('accept', "application/json") if (ApiKeyAuth !== undefined) headers.set("apiKey", ApiKeyAuth) const url = `${baseUrl.replace(/\/+$/, '')}/api/v1/token-screener${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "POST", headers, body: JSON.stringify(args.body)}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(tokenScreenerResponse, await res.json()) };