import {z} from 'zod' export type GetApiApiPublicV1LiveRiskCoinsCoinArgs = {coin: string}; export type GetApiApiPublicV1LiveRiskCoinsCoinOptions = {baseUrl?: string | undefined, apiKey?: string | undefined, fetch?: typeof fetch | undefined}; export const riskAvailability = z.object({historicalClearinghouse: z.boolean(), liquidations: z.boolean(), liveCandles: z.boolean(), markPrices: z.boolean(), userActions: z.boolean()}); export const riskFreshness = z.object({historicalClearinghouse: z.string().optional(), liquidations: z.string().optional(), liveCandles: z.string().optional(), livePositions: z.string().optional(), longShort: z.string().optional(), markPrices: z.string().optional()}); export const heatmapBucket = z.object({cumulativeLongNotional: z.number(), cumulativeShortNotional: z.number(), longNotionalAtRisk: z.number(), longPositions: z.number().int(), priceHigh: z.number(), priceLow: z.number(), shortNotionalAtRisk: z.number(), shortPositions: z.number().int(), totalNotionalAtRisk: z.number()}); export const liquidationHeatmapBody = z.object({$schema: z.string().optional(), buckets: z.array(heatmapBucket).nullable(), coin: z.string(), currentPrice: z.number(), timestamp: z.number().int(), totalLongAtRisk: z.number(), totalShortAtRisk: z.number()}); export const getLiquidationSummaryByCohortRow = z.object({count: z.number().int(), tier: z.string(), totalClosedPnl: z.unknown(), totalNotional: z.unknown(), wallets: z.number().int()}); export const getLiquidationSummaryByCoinRow = z.object({coin: z.string(), count: z.number().int(), totalClosedPnl: z.unknown(), totalNotional: z.unknown(), totalPenaltyFees: z.unknown()}); export const getLiquidationSummaryTimelineRow = z.object({bucketStart: z.number().int(), count: z.number().int(), totalClosedPnl: z.unknown(), totalNotional: z.unknown(), totalPenaltyFees: z.unknown()}); export const liquidationSummaryBody = z.object({$schema: z.string().optional(), availability: riskAvailability, avgClosedPnl: z.number(), avgPenaltyFee: z.number(), bucketSizeMs: z.number().int(), byCohort: z.array(getLiquidationSummaryByCohortRow).nullable().optional(), byCoin: z.array(getLiquidationSummaryByCoinRow).nullable(), coin: z.string().optional(), count: z.number().int(), freshness: riskFreshness, generatedAt: z.string(), longEvents: z.number().int(), longNotional: z.number(), shortEvents: z.number().int(), shortNotional: z.number(), since: z.string(), timeline: z.array(getLiquidationSummaryTimelineRow).nullable(), totalClosedPnl: z.number(), totalNotional: z.number(), totalPenaltyFees: z.number(), wallets: z.number().int()}); export const lSTopPosition = z.object({address: z.string(), notional: z.number(), pnl: z.number(), size: z.number()}); export const coinLongShortBody = z.object({$schema: z.string().optional(), avgLongLeverage: z.number().optional(), avgLongSize: z.number(), avgShortLeverage: z.number().optional(), avgShortSize: z.number(), coin: z.string(), concentrationTop5: z.number(), longAccounts: z.number().int(), longUnrealizedPnl: z.number(), longVolume: z.number(), maxLeverage: z.number().optional(), netBias: z.number(), ratio: z.number(), sampleSize: z.number().int(), shortAccounts: z.number().int(), shortUnrealizedPnl: z.number(), shortVolume: z.number(), timestamp: z.number().int(), topLongs: z.array(lSTopPosition).nullable(), topShorts: z.array(lSTopPosition).nullable(), totalUnrealizedPnl: z.number(), volumeRatio: z.number()}); export const getCoinStatsRow = z.object({avgLongLeverage: z.number(), avgShortLeverage: z.number(), coin: z.string(), longNotional: z.number(), longPositions: z.number().int(), shortNotional: z.number(), shortPositions: z.number().int(), totalOi: z.number(), totalPositions: z.number().int(), totalUnrealizedPnl: z.number(), uniqueWallets: z.number().int()}); export const getRecentLiquidationsRow = z.object({address: z.unknown(), closedPnl: z.number().nullable(), coin: z.string(), liquidator: z.unknown(), penaltyFee: z.number().nullable(), pnlTier: z.string().nullable(), timestampMs: z.number().int()}); export const getPositionSizeBreakdownRow = z.object({longCount: z.number().int(), longNotional: z.number(), positionCount: z.number().int(), shortCount: z.number().int(), shortNotional: z.number(), sizeBucket: z.string(), sortOrder: z.number().int(), totalNotional: z.number()}); export const getTopPositionsRow = z.object({address: z.unknown(), coin: z.string(), entryPx: z.number().nullable(), fundingSinceOpen: z.number().nullable(), leverage: z.number().nullable(), leverageType: z.string().nullable(), liquidationPx: z.number().nullable(), marginUsed: z.number().nullable(), markPx: z.number().nullable(), notional: z.number().nullable(), openedAtRaw: z.number().int().nullable(), pOpenedAt: z.string().nullable(), pUpdatedAt: z.string().nullable(), pnlTier: z.string().nullable(), roe: z.number().nullable(), side: z.string(), size: z.number().nullable(), sizeTier: z.string().nullable(), traderTotalPnl: z.string(), traderTotalTrades: z.number().int().nullable(), traderWinRate: z.number().nullable(), unrealizedPnl: z.number().nullable()}); export const coinRiskSnapshotBody = z.object({$schema: z.string().optional(), availability: riskAvailability, avgLiquidationDistancePct: z.number().optional(), coin: z.string(), concentrationTop5: z.number(), freshness: riskFreshness, generatedAt: z.string(), liquidationHeatmap: liquidationHeatmapBody, liquidationSummary7d: liquidationSummaryBody, longShort: coinLongShortBody, market: getCoinStatsRow, nearLiquidationNotional: z.number(), nearLiquidationPositions: z.number().int(), recentLiquidations: z.array(getRecentLiquidationsRow).nullable(), sizeBreakdown: z.array(getPositionSizeBreakdownRow).nullable(), topPositions: z.array(getTopPositionsRow).nullable()}); 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 API public v1 live risk coins by coin * * GET /api/public/v1/live/risk/coins/{coin} */ export const getApiApiPublicV1LiveRiskCoinsCoin = async (args: GetApiApiPublicV1LiveRiskCoinsCoinArgs, options?: GetApiApiPublicV1LiveRiskCoinsCoinOptions) => { const {baseUrl = "https://api.coinversa.ai", fetch: fetchFn = fetch, apiKey} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (apiKey !== undefined) headers.set("X-API-Key", apiKey) const url = `${baseUrl.replace(/\/+$/, '')}/api/public/v1/live/risk/coins/${encodeURIComponent(String(args.coin))}${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(coinRiskSnapshotBody, await res.json()) };