import {z} from 'zod' export type DateRange = {from?: string | undefined, to?: string | undefined}; export type PaginationRequest = {page?: number | undefined, per_page?: number | undefined}; export type PerpTraderType = 'all' | 'sm' | 'whale' | 'public_figure' | 'high_winrate_hl_perps_trader'; export type NumericRangeFilter = {min?: number | undefined, max?: number | undefined}; export type IntegerRangeFilter = {min?: number | undefined, max?: number | undefined}; export type PerpScreenerFilters = {trader_type?: PerpTraderType | undefined, only_smart_money?: boolean | undefined, sectors_filter?: Array | undefined, sm_label_filter?: Array | undefined, trader_label_filter?: Array | undefined, token_symbol?: string | undefined, volume?: NumericRangeFilter | undefined, buy_volume?: NumericRangeFilter | undefined, sell_volume?: NumericRangeFilter | undefined, buy_sell_pressure?: NumericRangeFilter | undefined, trader_count?: IntegerRangeFilter | undefined, mark_price?: NumericRangeFilter | undefined, funding?: NumericRangeFilter | undefined, previous_price_usd?: NumericRangeFilter | undefined, open_interest?: NumericRangeFilter | undefined, smart_money_volume?: NumericRangeFilter | undefined, smart_money_buy_volume?: NumericRangeFilter | undefined, smart_money_sell_volume?: NumericRangeFilter | undefined, net_position_change?: NumericRangeFilter | undefined, current_smart_money_position_longs_usd?: NumericRangeFilter | undefined, current_smart_money_position_shorts_usd?: NumericRangeFilter | undefined, smart_money_longs_count?: IntegerRangeFilter | undefined, smart_money_shorts_count?: IntegerRangeFilter | undefined}; export type PerpScreenerSortFieldDefault = 'token_symbol' | 'volume' | 'buy_volume' | 'sell_volume' | 'buy_sell_pressure' | 'trader_count' | 'mark_price' | 'funding' | 'previous_price_usd' | 'open_interest'; export type PerpScreenerSortFieldSmartMoney = 'token_symbol' | 'smart_money_volume' | 'smart_money_buy_volume' | 'smart_money_sell_volume' | 'net_position_change' | 'trader_count' | 'mark_price' | 'funding' | 'previous_price_usd' | 'open_interest' | 'current_smart_money_position_longs_usd' | 'current_smart_money_position_shorts_usd' | 'smart_money_longs_count' | 'smart_money_shorts_count'; export type PerpScreenerSortFieldNotableLabel = 'token_symbol' | 'volume' | 'buy_volume' | 'sell_volume' | 'net_position_change' | 'trader_count' | 'mark_price' | 'funding' | 'open_interest' | 'current_position_longs_usd' | 'current_position_shorts_usd' | 'longs_count' | 'shorts_count'; export type SortDirection = 'ASC' | 'DESC'; export type SortOrderUnionPerpScreenerSortFieldDefaultPerpScreenerSortFieldSmartMoneyPerpScreenerSortFieldNotableLabel = {field: PerpScreenerSortFieldDefault | PerpScreenerSortFieldSmartMoney | PerpScreenerSortFieldNotableLabel, direction: SortDirection}; export type PerpScreenerRequest = {date: DateRange, pagination?: PaginationRequest | undefined, filters?: PerpScreenerFilters | undefined, order_by?: Array | undefined}; export type CreateApiApiV1PerpScreenerArgs = {body: PerpScreenerRequest}; export type CreateApiApiV1PerpScreenerOptions = {baseUrl?: string | undefined, ApiKeyAuth?: string | undefined, fetch?: typeof fetch | undefined}; export const perpScreenerDataDefault = z.object({volume: z.number().optional(), buy_volume: z.number().optional(), sell_volume: z.number().optional(), buy_sell_pressure: z.number().optional(), trader_count: z.number().int().optional(), token_symbol: z.string(), mark_price: z.number().optional(), funding: z.number().optional(), open_interest: z.number().optional(), previous_price_usd: z.number().optional()}); export const perpScreenerDataSmartMoney = z.object({smart_money_volume: z.number().optional(), smart_money_buy_volume: z.number().optional(), smart_money_sell_volume: z.number().optional(), net_position_change: z.number().optional(), trader_count: z.number().int().optional(), token_symbol: z.string(), mark_price: z.number().optional(), funding: z.number().optional(), previous_price_usd: z.number().optional(), open_interest: z.number().optional(), current_smart_money_position_longs_usd: z.number().optional(), current_smart_money_position_shorts_usd: z.number().optional(), smart_money_longs_count: z.number().int().optional(), smart_money_shorts_count: z.number().int().optional()}); export const perpScreenerDataNotableLabel = z.object({volume: z.number().optional(), buy_volume: z.number().optional(), sell_volume: z.number().optional(), net_position_change: z.number().optional(), trader_count: z.number().int().optional(), token_symbol: z.string(), mark_price: z.number().optional(), funding: z.number().optional(), open_interest: z.number().optional(), current_position_longs_usd: z.number().optional(), current_position_shorts_usd: z.number().optional(), longs_count: z.number().int().optional(), shorts_count: z.number().int().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 perpScreenerResponse = z.object({data: z.array(z.union([perpScreenerDataDefault, perpScreenerDataSmartMoney, perpScreenerDataNotableLabel])), 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 }; /** * Get Perpetual Contract Screening Data * * POST /api/v1/perp-screener */ export const createApiApiV1PerpScreener = async (args: CreateApiApiV1PerpScreenerArgs, options?: CreateApiApiV1PerpScreenerOptions) => { 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/perp-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(perpScreenerResponse, await res.json()) };