import {z} from 'zod' export type CreateApiApiV1TraderAddressExportArgs = {'X-Query-Validation'?: 'strict' | undefined, address: string, format?: ('json' | 'ndjson' | 'csv') | undefined, fresh?: boolean | undefined}; export type CreateApiApiV1TraderAddressExportOptions = {baseUrl?: string | undefined, bearerAuth?: string | undefined, fetch?: typeof fetch | undefined}; export const traderExportPositionWatermark = z.object({source: z.string(), coverage: z.string(), generation: z.number().int().nullable(), data_as_of: z.string().nullable()}); export const traderExportPnlWatermark = z.object({source: z.string(), coverage: z.string(), revision: z.number().int().nullable(), observed_at: z.string().nullable()}); export const traderExportCategoryWatermark = z.object({source: z.string(), coverage: z.string(), publication_fence: z.string().nullable(), data_as_of: z.string().nullable()}); export const traderExportTradeWatermark = z.object({source: z.string(), coverage: z.string(), rows: z.number().int(), first_activity_date: z.string().nullable()}); export const traderExportSourceWatermarks = z.object({positions: traderExportPositionWatermark, pnl: traderExportPnlWatermark, categories: traderExportCategoryWatermark, trades: traderExportTradeWatermark}); export const traderExportGeneration = z.object({id: z.string(), selected_at: z.string(), consistency: z.literal("repeatable_read"), source_watermarks: traderExportSourceWatermarks}); export const traderExportArtifactManifest = z.object({manifest_version: z.string(), format: z.enum(["json", "ndjson", "csv"]), schema_version: z.enum(["trader-export-json-v1", "trader-export-ndjson-v1", "trader-export-csv-v1"]), coverage: z.enum(["full_envelope_and_trades", "trades_only"]), generation: traderExportGeneration, row_count: z.number().int(), content_size_bytes: z.number().int(), content_sha256: z.string(), compressed_size_bytes: z.number().int(), compressed_sha256: z.string()}); export const responseMeta = z.object({request_id: z.string(), cached: z.boolean(), cache_age_s: z.number().int().optional(), cost: z.number().int(), ranking_generation: z.number().int().optional(), ranking_as_of: z.string().optional(), directional_source: z.enum(["live", "degraded"]).optional(), ranking_source: z.enum(["live", "db_only"]).optional(), category_skill_source: z.enum(["live", "partial", "degraded", "unavailable"]).optional(), category_skill_model_version: z.string().optional(), category_skill_taxonomy_version: z.string().optional(), category_skill_platform: z.literal("polymarket").optional(), category_skill_scope: z.literal("observed_goldsky_primary_taker_fill").optional(), category_skill_source_coverage: z.enum(["partial_whale_threshold_fills", "graded_wallet_fills"]).optional(), category_skill_observation_started_at: z.string().optional(), category_skill_model_operationally_degraded: z.boolean().optional(), category_skill_status_counts: z.object({live: z.number().int().gte(0), insufficient: z.number().int().gte(0), stale: z.number().int().gte(0), unknown: z.number().int().gte(0), degraded: z.number().int().gte(0)}).optional(), category_skill_base_payload_hash: z.string().optional(), category_skill_enriched_base_payload_hash: z.string().optional()}); export const traderExportJob = z.object({object: z.literal("trader_export_job"), data: z.object({job_id: z.number().int(), status: z.enum(["queued", "running", "ready", "failed", "reconcile_required", "expired", "cancel_requested", "cancelled"]), format: z.enum(["json", "ndjson", "csv"]), total_trades: z.number().int().nullable(), processed_trades: z.number().int().nullable(), file_size: z.number().int().nullable(), error: z.string().nullable(), terminal: z.boolean(), next_action: z.enum(["poll", "download", "resubmit"]), poll_after_s: z.number().int().optional(), created_at: z.string(), started_at: z.string().nullable(), ready_at: z.string().nullable(), failed_at: z.string().nullable(), expires_at: z.string(), expired_at: z.string().nullable(), data_as_of: z.string().nullable(), cancel_requested_at: z.string().nullable(), cancelled_at: z.string().nullable(), attempt: z.number().int(), max_attempts: z.number().int(), artifact: z.object({artifact_id: z.string(), etag: z.string().nullable(), compressed_size_bytes: z.number().int().nullable(), content_type: z.enum(["application/json", "application/x-ndjson", "text/csv"]), content_encoding: z.literal("gzip"), manifest: traderExportArtifactManifest.nullable()}).optional()}), meta: responseMeta}); 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 }; /** * Submit a trader dataset export job * * POST /api/v1/trader/{address}/export * * Also accepts auth: oauth2 */ export const createApiApiV1TraderAddressExport = async (args: CreateApiApiV1TraderAddressExportArgs, options?: CreateApiApiV1TraderAddressExportOptions) => { const {baseUrl = "https://api.0xinsider.com", fetch: fetchFn = fetch, bearerAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args['X-Query-Validation'] != null) headers.set("X-Query-Validation", String(args['X-Query-Validation'])) if (args.format != null) query.append("format", String(args.format)) if (args.fresh != null) query.append("fresh", String(args.fresh)) if (bearerAuth !== undefined) headers.set('authorization', `Bearer ${bearerAuth}`) const url = `${baseUrl.replace(/\/+$/, '')}/api/v1/trader/${encodeURIComponent(String(args.address))}/export${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "POST", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(traderExportJob, await res.json()) };