import {z} from 'zod' export type GetApiDefiV3TokenListArgs = {'x-chain'?: ('solana' | 'base' | 'bsc' | 'ethereum' | 'monad' | 'fogo' | 'mantle' | 'hyperevm' | 'megaeth' | 'robinhood') | undefined, sort_by: 'liquidity' | 'market_cap' | 'fdv' | 'recent_listing_time' | 'last_trade_unix_time' | 'holder' | 'volume_1m_usd' | 'volume_5m_usd' | 'volume_30m_usd' | 'volume_1h_usd' | 'volume_2h_usd' | 'volume_4h_usd' | 'volume_8h_usd' | 'volume_24h_usd' | 'volume_7d_usd' | 'volume_30d_usd' | 'volume_1m_change_percent' | 'volume_5m_change_percent' | 'volume_30m_change_percent' | 'volume_1h_change_percent' | 'volume_2h_change_percent' | 'volume_4h_change_percent' | 'volume_8h_change_percent' | 'volume_24h_change_percent' | 'volume_7d_change_percent' | 'volume_30d_change_percent' | 'price_change_1m_percent' | 'price_change_5m_percent' | 'price_change_30m_percent' | 'price_change_1h_percent' | 'price_change_2h_percent' | 'price_change_4h_percent' | 'price_change_8h_percent' | 'price_change_24h_percent' | 'price_change_7d_percent' | 'price_change_30d_percent' | 'trade_1m_count' | 'trade_5m_count' | 'trade_30m_count' | 'trade_1h_count' | 'trade_2h_count' | 'trade_4h_count' | 'trade_8h_count' | 'trade_24h_count' | 'trade_7d_count' | 'trade_30d_count' | 'global_fees_paid', sort_type: 'desc' | 'asc', min_liquidity?: number | undefined, max_liquidity?: number | undefined, min_market_cap?: number | undefined, max_market_cap?: number | undefined, min_fdv?: number | undefined, max_fdv?: number | undefined, min_recent_listing_time?: number | undefined, max_recent_listing_time?: number | undefined, min_last_trade_unix_time?: number | undefined, max_last_trade_unix_time?: number | undefined, min_holder?: number | undefined, min_volume_1m_usd?: number | undefined, min_volume_5m_usd?: number | undefined, min_volume_30m_usd?: number | undefined, min_volume_1h_usd?: number | undefined, min_volume_2h_usd?: number | undefined, min_volume_4h_usd?: number | undefined, min_volume_8h_usd?: number | undefined, min_volume_24h_usd?: number | undefined, min_volume_7d_usd?: number | undefined, min_volume_30d_usd?: number | undefined, min_volume_1m_change_percent?: number | undefined, min_volume_5m_change_percent?: number | undefined, min_volume_30m_change_percent?: number | undefined, min_volume_1h_change_percent?: number | undefined, min_volume_2h_change_percent?: number | undefined, min_volume_4h_change_percent?: number | undefined, min_volume_8h_change_percent?: number | undefined, min_volume_24h_change_percent?: number | undefined, min_volume_7d_change_percent?: number | undefined, min_volume_30d_change_percent?: number | undefined, min_price_change_1m_percent?: number | undefined, min_price_change_5m_percent?: number | undefined, min_price_change_30m_percent?: number | undefined, min_price_change_1h_percent?: number | undefined, min_price_change_2h_percent?: number | undefined, min_price_change_4h_percent?: number | undefined, min_price_change_8h_percent?: number | undefined, min_price_change_24h_percent?: number | undefined, min_price_change_7d_percent?: number | undefined, min_price_change_30d_percent?: number | undefined, min_trade_1m_count?: number | undefined, min_trade_5m_count?: number | undefined, min_trade_30m_count?: number | undefined, min_trade_1h_count?: number | undefined, min_trade_2h_count?: number | undefined, min_trade_4h_count?: number | undefined, min_trade_8h_count?: number | undefined, min_trade_24h_count?: number | undefined, min_trade_7d_count?: number | undefined, min_trade_30d_count?: number | undefined, min_global_fees_paid?: number | undefined, offset?: number | undefined, limit?: number | undefined, ui_amount_mode?: ('raw' | 'scaled') | undefined}; export type GetApiDefiV3TokenListOptions = {baseUrl?: string | undefined, apiKeyAuth?: string | undefined, fetch?: typeof fetch | undefined}; export const defiTokenListV3Response = z.object({success: z.boolean(), data: z.object({items: z.array(z.object({address: z.string().optional(), name: z.string().optional(), symbols: z.string().optional(), decimals: z.number().int().optional(), logo_uri: z.string().optional(), market_cap: z.number().optional(), fdv: z.number().optional(), liquidity: z.number().optional(), price: z.number().optional(), holder: z.number().int().optional(), volume_1h_usd: z.number().optional(), volume_1h_change_percent: z.number().optional(), price_change_1h_percent: z.number().optional(), trade_1h_count: z.number().int().optional(), volume_2h_usd: z.number().optional(), volume_2h_change_percent: z.number().optional(), price_change_2h_percent: z.number().optional(), trade_2h_count: z.number().int().optional(), volume_4h_usd: z.number().optional(), volume_4h_change_percent: z.number().optional(), price_change_4h_percent: z.number().optional(), trade_4h_count: z.number().int().optional(), volume_8h_usd: z.number().optional(), volume_8h_change_percent: z.number().optional(), price_change_8h_percent: z.number().optional(), trade_8h_count: z.number().int().optional(), volume_24h_usd: z.number().optional(), volume_24h_change_percent: z.number().optional(), price_change_24h_percent: z.number().optional(), trade_24h_count: z.number().int().optional(), recent_listing_time: z.number().int().optional(), global_fees_paid: z.number().nullable().optional()})).optional()})}); 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 }; /** * Token - List (V3) * * GET /defi/v3/token/list */ export const getApiDefiV3TokenList = async (args: GetApiDefiV3TokenListArgs, options?: GetApiDefiV3TokenListOptions) => { const {baseUrl = "https://public-api.birdeye.so", fetch: fetchFn = fetch, apiKeyAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args['x-chain'] != null) headers.set("x-chain", String(args['x-chain'])) if (args.sort_by != null) query.append("sort_by", String(args.sort_by)) if (args.sort_type != null) query.append("sort_type", String(args.sort_type)) if (args.min_liquidity != null) query.append("min_liquidity", String(args.min_liquidity)) if (args.max_liquidity != null) query.append("max_liquidity", String(args.max_liquidity)) if (args.min_market_cap != null) query.append("min_market_cap", String(args.min_market_cap)) if (args.max_market_cap != null) query.append("max_market_cap", String(args.max_market_cap)) if (args.min_fdv != null) query.append("min_fdv", String(args.min_fdv)) if (args.max_fdv != null) query.append("max_fdv", String(args.max_fdv)) if (args.min_recent_listing_time != null) query.append("min_recent_listing_time", String(args.min_recent_listing_time)) if (args.max_recent_listing_time != null) query.append("max_recent_listing_time", String(args.max_recent_listing_time)) if (args.min_last_trade_unix_time != null) query.append("min_last_trade_unix_time", String(args.min_last_trade_unix_time)) if (args.max_last_trade_unix_time != null) query.append("max_last_trade_unix_time", String(args.max_last_trade_unix_time)) if (args.min_holder != null) query.append("min_holder", String(args.min_holder)) if (args.min_volume_1m_usd != null) query.append("min_volume_1m_usd", String(args.min_volume_1m_usd)) if (args.min_volume_5m_usd != null) query.append("min_volume_5m_usd", String(args.min_volume_5m_usd)) if (args.min_volume_30m_usd != null) query.append("min_volume_30m_usd", String(args.min_volume_30m_usd)) if (args.min_volume_1h_usd != null) query.append("min_volume_1h_usd", String(args.min_volume_1h_usd)) if (args.min_volume_2h_usd != null) query.append("min_volume_2h_usd", String(args.min_volume_2h_usd)) if (args.min_volume_4h_usd != null) query.append("min_volume_4h_usd", String(args.min_volume_4h_usd)) if (args.min_volume_8h_usd != null) query.append("min_volume_8h_usd", String(args.min_volume_8h_usd)) if (args.min_volume_24h_usd != null) query.append("min_volume_24h_usd", String(args.min_volume_24h_usd)) if (args.min_volume_7d_usd != null) query.append("min_volume_7d_usd", String(args.min_volume_7d_usd)) if (args.min_volume_30d_usd != null) query.append("min_volume_30d_usd", String(args.min_volume_30d_usd)) if (args.min_volume_1m_change_percent != null) query.append("min_volume_1m_change_percent", String(args.min_volume_1m_change_percent)) if (args.min_volume_5m_change_percent != null) query.append("min_volume_5m_change_percent", String(args.min_volume_5m_change_percent)) if (args.min_volume_30m_change_percent != null) query.append("min_volume_30m_change_percent", String(args.min_volume_30m_change_percent)) if (args.min_volume_1h_change_percent != null) query.append("min_volume_1h_change_percent", String(args.min_volume_1h_change_percent)) if (args.min_volume_2h_change_percent != null) query.append("min_volume_2h_change_percent", String(args.min_volume_2h_change_percent)) if (args.min_volume_4h_change_percent != null) query.append("min_volume_4h_change_percent", String(args.min_volume_4h_change_percent)) if (args.min_volume_8h_change_percent != null) query.append("min_volume_8h_change_percent", String(args.min_volume_8h_change_percent)) if (args.min_volume_24h_change_percent != null) query.append("min_volume_24h_change_percent", String(args.min_volume_24h_change_percent)) if (args.min_volume_7d_change_percent != null) query.append("min_volume_7d_change_percent", String(args.min_volume_7d_change_percent)) if (args.min_volume_30d_change_percent != null) query.append("min_volume_30d_change_percent", String(args.min_volume_30d_change_percent)) if (args.min_price_change_1m_percent != null) query.append("min_price_change_1m_percent", String(args.min_price_change_1m_percent)) if (args.min_price_change_5m_percent != null) query.append("min_price_change_5m_percent", String(args.min_price_change_5m_percent)) if (args.min_price_change_30m_percent != null) query.append("min_price_change_30m_percent", String(args.min_price_change_30m_percent)) if (args.min_price_change_1h_percent != null) query.append("min_price_change_1h_percent", String(args.min_price_change_1h_percent)) if (args.min_price_change_2h_percent != null) query.append("min_price_change_2h_percent", String(args.min_price_change_2h_percent)) if (args.min_price_change_4h_percent != null) query.append("min_price_change_4h_percent", String(args.min_price_change_4h_percent)) if (args.min_price_change_8h_percent != null) query.append("min_price_change_8h_percent", String(args.min_price_change_8h_percent)) if (args.min_price_change_24h_percent != null) query.append("min_price_change_24h_percent", String(args.min_price_change_24h_percent)) if (args.min_price_change_7d_percent != null) query.append("min_price_change_7d_percent", String(args.min_price_change_7d_percent)) if (args.min_price_change_30d_percent != null) query.append("min_price_change_30d_percent", String(args.min_price_change_30d_percent)) if (args.min_trade_1m_count != null) query.append("min_trade_1m_count", String(args.min_trade_1m_count)) if (args.min_trade_5m_count != null) query.append("min_trade_5m_count", String(args.min_trade_5m_count)) if (args.min_trade_30m_count != null) query.append("min_trade_30m_count", String(args.min_trade_30m_count)) if (args.min_trade_1h_count != null) query.append("min_trade_1h_count", String(args.min_trade_1h_count)) if (args.min_trade_2h_count != null) query.append("min_trade_2h_count", String(args.min_trade_2h_count)) if (args.min_trade_4h_count != null) query.append("min_trade_4h_count", String(args.min_trade_4h_count)) if (args.min_trade_8h_count != null) query.append("min_trade_8h_count", String(args.min_trade_8h_count)) if (args.min_trade_24h_count != null) query.append("min_trade_24h_count", String(args.min_trade_24h_count)) if (args.min_trade_7d_count != null) query.append("min_trade_7d_count", String(args.min_trade_7d_count)) if (args.min_trade_30d_count != null) query.append("min_trade_30d_count", String(args.min_trade_30d_count)) if (args.min_global_fees_paid != null) query.append("min_global_fees_paid", String(args.min_global_fees_paid)) if (args.offset != null) query.append("offset", String(args.offset)) if (args.limit != null) query.append("limit", String(args.limit)) if (args.ui_amount_mode != null) query.append("ui_amount_mode", String(args.ui_amount_mode)) if (apiKeyAuth !== undefined) headers.set("X-API-KEY", apiKeyAuth) const url = `${baseUrl.replace(/\/+$/, '')}/defi/v3/token/list${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "GET", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(defiTokenListV3Response, await res.json()) };