pandora-cli-skills 1.1.55 → 1.1.57

package/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: pandora-cli-skills
 summary: Canonical skill and operator guide for Pandora CLI including mirror, polymarket, resolve, and LP flows.
-version: 1.1.55
+version: 1.1.57
 ---
 
 # Pandora CLI & Skills

package/cli/lib/arb_command_service.cjs

@@ -14,7 +14,7 @@ const ARB_MARKET_FIELDS = [
 ];
 
 const ARB_USAGE =
-  'pandora arb scan [--source pandora|polymarket] [--markets <csv>] --output ndjson|json [--limit <n>] [--min-net-spread-pct <n>|--min-spread-pct <n>] [--min-tvl <usdc>] [--fee-pct-per-leg <n>] [--slippage-pct-per-leg <n>] [--amount-usdc <n>] [--combinatorial] [--max-bundle-size <n>] [--interval-ms <ms>] [--iterations <n>] [--indexer-url <url>] [--timeout-ms <ms>]';
+  'pandora arb scan [--source pandora|polymarket] [--markets <csv>] --output ndjson|json [--limit <n>] [--min-net-spread-pct <n>|--min-spread-pct <n>] [--min-tvl <usdc>] [--fee-pct-per-leg <n>] [--slippage-pct-per-leg <n>] [--amount-usdc <n>] [--combinatorial] [--max-bundle-size <n>] [--similarity-threshold <0-1>] [--min-token-score <0-1>] [--max-close-diff-hours <n>] [--question-contains <text>] [--interval-ms <ms>] [--iterations <n>] [--indexer-url <url>] [--timeout-ms <ms>]';
 
 function requireDep(deps, name) {
   if (!deps || typeof deps[name] !== 'function') {
@@ -87,6 +87,12 @@ function buildMarketSnapshots(markets, orderedIds) {
 function buildCrossVenueArbOpportunities(payload, options) {
   const opportunities = Array.isArray(payload && payload.opportunities) ? payload.opportunities : [];
   const minSpreadPct = Number.isFinite(options.minNetSpreadPct) ? Number(options.minNetSpreadPct) : 0;
+  const feePctPerLeg = Number.isFinite(options.feePctPerLeg) ? Number(options.feePctPerLeg) : 0;
+  const slippagePctPerLeg = Number.isFinite(options.slippagePctPerLeg) ? Number(options.slippagePctPerLeg) : 0;
+  const feeImpactPct = roundNumber(Math.max(0, feePctPerLeg) * 2, 6);
+  const slippageImpactPct = roundNumber(Math.max(0, slippagePctPerLeg) * 2, 6);
+  const totalImpactPct = roundNumber(feeImpactPct + slippageImpactPct, 6);
+  const minTvlUsdc = Number.isFinite(options.minTvlUsdc) ? Number(options.minTvlUsdc) : 0;
   const rows = [];
   for (const item of opportunities) {
     const legs = Array.isArray(item.legs) ? item.legs : [];
@@ -96,7 +102,21 @@ function buildCrossVenueArbOpportunities(payload, options) {
 
     const spreadYesPct = toFiniteNumber(item.spreadYesPct);
     const spreadNoPct = toFiniteNumber(item.spreadNoPct);
-    const netSpreadPct = Math.max(spreadYesPct === null ? 0 : spreadYesPct, spreadNoPct === null ? 0 : spreadNoPct);
+    const grossSpreadPct = Math.max(spreadYesPct === null ? 0 : spreadYesPct, spreadNoPct === null ? 0 : spreadNoPct);
+    const pandoraLiquidityUsd = toFiniteNumber(pandoraLeg.liquidityUsd);
+    const polymarketLiquidityUsd = toFiniteNumber(polyLeg.liquidityUsd);
+    const minLegLiquidityUsd =
+      pandoraLiquidityUsd !== null && polymarketLiquidityUsd !== null
+        ? Math.min(pandoraLiquidityUsd, polymarketLiquidityUsd)
+        : null;
+
+    if (minTvlUsdc > 0) {
+      if (minLegLiquidityUsd === null || minLegLiquidityUsd < minTvlUsdc) {
+        continue;
+      }
+    }
+
+    const netSpreadPct = grossSpreadPct - totalImpactPct;
     if (netSpreadPct < minSpreadPct) continue;
 
     rows.push({
@@ -109,8 +129,14 @@ function buildCrossVenueArbOpportunities(payload, options) {
       polymarketUrl: polyLeg.url || null,
       pandoraYesPct: toFiniteNumber(pandoraLeg.yesPct),
       polymarketYesPct: toFiniteNumber(polyLeg.yesPct),
+      pandoraLiquidityUsd,
+      polymarketLiquidityUsd,
+      minLegLiquidityUsd,
+      grossSpreadPct: roundNumber(grossSpreadPct, 6),
       spreadYesPct,
       spreadNoPct,
+      feeImpactPct,
+      slippageImpactPct,
       netSpreadPct: roundNumber(netSpreadPct, 6),
       confidenceScore: toFiniteNumber(item.confidenceScore),
       riskFlags: Array.isArray(item.riskFlags) ? item.riskFlags : [],
@@ -314,6 +340,10 @@ function parseArbScanFlags(args, deps) {
     amountUsdc: 100,
     combinatorial: false,
     maxBundleSize: 4,
+    similarityThreshold: 0.35,
+    minTokenScore: 0.12,
+    maxCloseDiffHours: 24,
+    questionContains: null,
     intervalMs: 5_000,
     iterations: null,
   };
@@ -380,6 +410,29 @@ function parseArbScanFlags(args, deps) {
       i += 1;
       continue;
     }
+    if (token === '--similarity-threshold') {
+      options.similarityThreshold = parseNumber(requireFlagValue(rest, i, '--similarity-threshold'), '--similarity-threshold');
+      i += 1;
+      continue;
+    }
+    if (token === '--min-token-score') {
+      options.minTokenScore = parseNumber(requireFlagValue(rest, i, '--min-token-score'), '--min-token-score');
+      i += 1;
+      continue;
+    }
+    if (token === '--max-close-diff-hours') {
+      options.maxCloseDiffHours = parsePositiveNumber(
+        requireFlagValue(rest, i, '--max-close-diff-hours'),
+        '--max-close-diff-hours',
+      );
+      i += 1;
+      continue;
+    }
+    if (token === '--question-contains') {
+      options.questionContains = String(requireFlagValue(rest, i, '--question-contains')).trim();
+      i += 1;
+      continue;
+    }
     if (token === '--interval-ms') {
       options.intervalMs = parsePositiveInteger(requireFlagValue(rest, i, '--interval-ms'), '--interval-ms');
       i += 1;
@@ -417,6 +470,12 @@ function parseArbScanFlags(args, deps) {
   if (options.slippagePctPerLeg < 0) {
     throw new CliError('INVALID_FLAG_VALUE', '--slippage-pct-per-leg must be >= 0.');
   }
+  if (options.similarityThreshold < 0 || options.similarityThreshold > 1) {
+    throw new CliError('INVALID_FLAG_VALUE', '--similarity-threshold must be between 0 and 1.');
+  }
+  if (options.minTokenScore < 0 || options.minTokenScore > 1) {
+    throw new CliError('INVALID_FLAG_VALUE', '--min-token-score must be between 0 and 1.');
+  }
 
   if (!Number.isInteger(options.maxBundleSize) || options.maxBundleSize < 3) {
     throw new CliError('INVALID_FLAG_VALUE', '--max-bundle-size must be an integer >= 3.');
@@ -530,15 +589,16 @@ function createRunArbCommand(deps) {
           timeoutMs: shared.timeoutMs,
           chainId: null,
           venues: ['pandora', 'polymarket'],
-          limit: options.limit,
+          limit: Math.max(options.limit * 4, 100),
           minSpreadPct: options.minNetSpreadPct,
           minLiquidityUsd: options.minTvlUsdc,
-          maxCloseDiffHours: 24,
-          similarityThreshold: 0.86,
+          maxCloseDiffHours: options.maxCloseDiffHours,
+          similarityThreshold: options.similarityThreshold,
+          minTokenScore: options.minTokenScore,
           crossVenueOnly: true,
           withRules: false,
           includeSimilarity: false,
-          questionContains: null,
+          questionContains: options.questionContains,
         });
         pairwiseOpportunities = buildCrossVenueArbOpportunities(crossVenuePayload, options);
         combinatorialOpportunities = [];
@@ -626,6 +686,10 @@ function createRunArbCommand(deps) {
           amountUsdc: options.amountUsdc,
           combinatorial: options.combinatorial,
           maxBundleSize: options.maxBundleSize,
+          similarityThreshold: options.similarityThreshold,
+          minTokenScore: options.minTokenScore,
+          maxCloseDiffHours: options.maxCloseDiffHours,
+          questionContains: options.questionContains,
         },
         opportunities: iterationSnapshots.flatMap((row) => row.opportunities),
         snapshots: iterationSnapshots,
@@ -645,6 +709,7 @@ function createRunArbCommand(deps) {
 module.exports = {
   ARB_USAGE,
   buildArbOpportunities,
+  buildCrossVenueArbOpportunities,
   buildCombinatorialArbOpportunities,
   createRunArbCommand,
   parseArbScanFlags,

package/cli/lib/arbitrage_service.cjs

@@ -8,6 +8,7 @@ const {
 const { toNumber, round } = require('./shared/utils.cjs');
 
 const ARBITRAGE_SCHEMA_VERSION = '1.1.0';
+const DEFAULT_MIN_TOKEN_SCORE = 0.12;
 
 function toUsdc(raw) {
   const numeric = toNumber(raw);
@@ -170,6 +171,9 @@ async function fetchPandoraLegs(options, diagnostics) {
 }
 
 function buildGroups(legs, options) {
+  const minTokenScore = Number.isFinite(options && options.minTokenScore)
+    ? Number(options.minTokenScore)
+    : DEFAULT_MIN_TOKEN_SCORE;
   const parent = new Map();
   const acceptedPairChecks = new Map();
   const makePairKey = (a, b) => [a, b].sort().join('|');
@@ -202,6 +206,7 @@ function buildGroups(legs, options) {
       if (options.crossVenueOnly && left.venue === right.venue) continue;
 
       const similarity = questionSimilarityBreakdown(left.question, right.question);
+      if (similarity.tokenScore < minTokenScore) continue;
       if (similarity.score < options.similarityThreshold) continue;
 
       let closeDiffHours = null;
@@ -587,6 +592,9 @@ async function scanArbitrage(options) {
         timeoutMs: options.timeoutMs,
         limit: Math.max(options.limit * 3, 100),
       });
+      if (Array.isArray(poly.diagnostics) && poly.diagnostics.length) {
+        diagnostics.push(...poly.diagnostics);
+      }
 
       const filtered = poly.items.filter((item) => {
         if (!item.question) return false;
@@ -627,6 +635,9 @@ async function scanArbitrage(options) {
         minLiquidityUsd: options.minLiquidityUsd,
         maxCloseDiffHours: options.maxCloseDiffHours,
         similarityThreshold: options.similarityThreshold,
+        minTokenScore: Number.isFinite(options.minTokenScore)
+          ? options.minTokenScore
+          : DEFAULT_MIN_TOKEN_SCORE,
         crossVenueOnly: options.crossVenueOnly,
         withRules: options.withRules,
         includeSimilarity: options.includeSimilarity,
@@ -694,6 +705,9 @@ async function scanArbitrage(options) {
       minLiquidityUsd: options.minLiquidityUsd,
       maxCloseDiffHours: options.maxCloseDiffHours,
       similarityThreshold: options.similarityThreshold,
+      minTokenScore: Number.isFinite(options.minTokenScore)
+        ? options.minTokenScore
+        : DEFAULT_MIN_TOKEN_SCORE,
       crossVenueOnly: options.crossVenueOnly,
       withRules: options.withRules,
       includeSimilarity: options.includeSimilarity,

package/cli/lib/parsers/core_command_flags.cjs

@@ -1153,6 +1153,7 @@ function createCoreCommandFlagParsers(deps) {
       minLiquidityUsd: 1000,
       maxCloseDiffHours: 24,
       similarityThreshold: 0.86,
+      minTokenScore: 0.12,
       crossVenueOnly: true,
       withRules: false,
       includeSimilarity: false,
@@ -1186,7 +1187,7 @@ function createCoreCommandFlagParsers(deps) {
         continue;
       }
       if (token === '--min-spread-pct') {
-        options.minSpreadPct = parsePositiveNumber(requireFlagValue(args, i, '--min-spread-pct'), '--min-spread-pct');
+        options.minSpreadPct = parseNumber(requireFlagValue(args, i, '--min-spread-pct'), '--min-spread-pct');
         i += 1;
         continue;
       }
@@ -1214,6 +1215,14 @@ function createCoreCommandFlagParsers(deps) {
         i += 1;
         continue;
       }
+      if (token === '--min-token-score') {
+        options.minTokenScore = parseNumber(requireFlagValue(args, i, '--min-token-score'), '--min-token-score');
+        if (options.minTokenScore < 0 || options.minTokenScore > 1) {
+          throw new CliError('INVALID_FLAG_VALUE', '--min-token-score must be between 0 and 1.');
+        }
+        i += 1;
+        continue;
+      }
       if (token === '--cross-venue-only') {
         options.crossVenueOnly = true;
         continue;
@@ -1249,6 +1258,10 @@ function createCoreCommandFlagParsers(deps) {
       throw new CliError('UNKNOWN_FLAG', `Unknown flag for arbitrage: ${token}`);
     }
 
+    if (options.minSpreadPct < 0) {
+      throw new CliError('INVALID_FLAG_VALUE', '--min-spread-pct must be >= 0.');
+    }
+
     return options;
   }
 

package/cli/lib/polymarket_adapter.cjs

@@ -2,6 +2,7 @@ const { ClobClient, Chain } = require('@polymarket/clob-client');
 const { toNumber } = require('./shared/utils.cjs');
 
 const DEFAULT_POLYMARKET_HOST = 'https://clob.polymarket.com';
+const DEFAULT_POLYMARKET_GAMMA_HOST = 'https://gamma-api.polymarket.com';
 
 function toTimestampSeconds(value) {
   if (!value) return null;
@@ -53,6 +54,66 @@ function normalizeTokens(tokens) {
   };
 }
 
+function safeParseJsonArray(value) {
+  if (Array.isArray(value)) return value;
+  if (typeof value !== 'string') return null;
+  try {
+    const parsed = JSON.parse(value);
+    return Array.isArray(parsed) ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+
+function buildTokensFromGammaPayload(row) {
+  const outcomes = safeParseJsonArray(row && row.outcomes) || safeParseJsonArray(row && row.outcomeNames);
+  const prices = safeParseJsonArray(row && row.outcomePrices) || safeParseJsonArray(row && row.prices);
+  if (!Array.isArray(outcomes) || !Array.isArray(prices) || outcomes.length !== prices.length || !outcomes.length) {
+    return null;
+  }
+  const tokens = [];
+  for (let index = 0; index < outcomes.length; index += 1) {
+    tokens.push({
+      outcome: String(outcomes[index] || ''),
+      price: prices[index],
+    });
+  }
+  return tokens;
+}
+
+function mapGammaRow(row) {
+  const tokens =
+    (Array.isArray(row && row.tokens) ? row.tokens : null) ||
+    (Array.isArray(row && row.outcomePrices) && Array.isArray(row && row.outcomes)
+      ? row.outcomes.map((outcome, index) => ({ outcome, price: row.outcomePrices[index] }))
+      : null) ||
+    buildTokensFromGammaPayload(row);
+  const mapped = normalizeTokens(tokens || []);
+  const marketId = row && (row.conditionId || row.condition_id || row.id || row.questionID) ? String(
+    row.conditionId || row.condition_id || row.id || row.questionID,
+  ) : null;
+  const closeTimestamp = toTimestampSeconds(
+    row && (row.endDateIso || row.end_date_iso || row.endDate || row.game_start_time || row.closedTime),
+  );
+  return {
+    legId: `polymarket:${String(marketId || '')}`,
+    venue: 'polymarket',
+    marketId,
+    question: row && (row.question || row.title || row.description) ? String(row.question || row.title || row.description) : null,
+    closeTimestamp,
+    yesPct: mapped.yes,
+    noPct: mapped.no,
+    liquidityUsd: toNumber(row && (row.liquidityNum || row.liquidity || row.liquidityClob)),
+    volumeUsd: toNumber(row && (row.volumeNum || row.volume || row.volumeClob)),
+    url: row && (row.market_slug || row.slug) ? `https://polymarket.com/event/${String(row.market_slug || row.slug)}` : null,
+    oddsSource: 'polymarket:gamma-markets',
+    diagnostics: mapped.diagnostics,
+    rules: row && row.description ? String(row.description) : null,
+    sources: [],
+    pollStatus: null,
+  };
+}
+
 function mapPolymarketRow(row) {
   const mapped = normalizeTokens(row.tokens || []);
   const question = row.question || row.description || null;
@@ -101,41 +162,138 @@ async function fetchMockPolymarketMarkets(mockUrl, timeoutMs) {
   }
 }
 
-async function fetchPolymarketMarkets(options = {}) {
-  const host = options.host || DEFAULT_POLYMARKET_HOST;
+async function fetchJsonWithTimeout(url, timeoutMs) {
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const response = await fetch(url, {
+      method: 'GET',
+      headers: { accept: 'application/json' },
+      signal: controller.signal,
+    });
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status} from ${url}`);
+    }
+    return response.json();
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+
+function normalizeGammaMarketRows(payload) {
+  if (Array.isArray(payload)) return payload;
+  if (payload && Array.isArray(payload.data)) return payload.data;
+  if (payload && Array.isArray(payload.markets)) return payload.markets;
+  return [];
+}
+
+async function fetchGammaPolymarketMarkets(options = {}) {
+  const gammaHostRaw =
+    options.gammaHost ||
+    process.env.POLYMARKET_GAMMA_HOST ||
+    DEFAULT_POLYMARKET_GAMMA_HOST;
+  const gammaHost = String(gammaHostRaw || '').replace(/\/+$/, '');
   const limit = Number.isInteger(options.limit) && options.limit > 0 ? options.limit : 100;
   const timeoutMs = Number.isInteger(options.timeoutMs) && options.timeoutMs > 0 ? options.timeoutMs : 12_000;
 
+  const rows = [];
+  let offset = 0;
+  let loopCount = 0;
+  while (rows.length < limit && loopCount < 10) {
+    loopCount += 1;
+    const pageLimit = Math.min(200, Math.max(25, limit - rows.length));
+    const url =
+      `${gammaHost}/markets?active=true&closed=false&archived=false&order=volume` +
+      `&ascending=false&limit=${pageLimit}&offset=${offset}`;
+    const payload = await fetchJsonWithTimeout(url, timeoutMs);
+    const batch = normalizeGammaMarketRows(payload);
+    if (!batch.length) break;
+    rows.push(...batch);
+    if (batch.length < pageLimit) break;
+    offset += batch.length;
+  }
+
+  return {
+    host: gammaHost,
+    rows,
+  };
+}
+
+async function fetchClobPolymarketMarkets(options = {}) {
+  const host = options.host || DEFAULT_POLYMARKET_HOST;
+  const limit = Number.isInteger(options.limit) && options.limit > 0 ? options.limit : 100;
+  const client = new ClobClient(host, Chain.POLYGON);
+  const rows = [];
+  let cursor;
+  let loops = 0;
+  while (rows.length < limit && loops < 8) {
+    loops += 1;
+    const page = cursor ? await client.getMarkets(cursor) : await client.getMarkets();
+    const data = Array.isArray(page && page.data) ? page.data : [];
+    rows.push(...data);
+    if (!page || !page.next_cursor || page.next_cursor === cursor) break;
+    cursor = page.next_cursor;
+  }
+  return { host, rows };
+}
+
+async function fetchPolymarketMarkets(options = {}) {
+  const limit = Number.isInteger(options.limit) && options.limit > 0 ? options.limit : 100;
+  const timeoutMs = Number.isInteger(options.timeoutMs) && options.timeoutMs > 0 ? options.timeoutMs : 12_000;
+  const diagnostics = [];
   let rows = [];
+  let source = 'polymarket:clob';
+  let host = options.host || DEFAULT_POLYMARKET_HOST;
 
   if (options.mockUrl) {
     rows = await fetchMockPolymarketMarkets(options.mockUrl, timeoutMs);
+    source = 'polymarket:mock';
   } else {
-    const client = new ClobClient(host, Chain.POLYGON);
-    let cursor;
-    let loops = 0;
-    while (rows.length < limit && loops < 5) {
-      loops += 1;
-      const page = cursor ? await client.getMarkets(cursor) : await client.getMarkets();
-      const data = Array.isArray(page && page.data) ? page.data : [];
-      rows.push(...data);
-      if (!page || !page.next_cursor || page.next_cursor === cursor) {
-        break;
+    let gammaResult = null;
+    try {
+      const preferredGammaHost =
+        options.host && /gamma-api\.polymarket\.com/i.test(String(options.host))
+          ? options.host
+          : options.gammaHost;
+      gammaResult = await fetchGammaPolymarketMarkets({
+        gammaHost: preferredGammaHost,
+        timeoutMs,
+        limit,
+      });
+      if (Array.isArray(gammaResult.rows) && gammaResult.rows.length) {
+        rows = gammaResult.rows;
+        source = 'polymarket:gamma';
+        host = gammaResult.host;
       }
-      cursor = page.next_cursor;
+    } catch (err) {
+      diagnostics.push(`Gamma markets fetch failed: ${err && err.message ? err.message : String(err)}`);
+    }
+
+    if (!rows.length) {
+      const clob = await fetchClobPolymarketMarkets({
+        host: options.host,
+        timeoutMs,
+        limit,
+      });
+      rows = clob.rows;
+      source = 'polymarket:clob';
+      host = clob.host;
     }
   }
 
-  const mapped = rows.slice(0, limit).map(mapPolymarketRow);
+  const mapper = source === 'polymarket:gamma' ? mapGammaRow : mapPolymarketRow;
+  const mapped = rows.slice(0, limit).map(mapper);
   return {
     host,
-    source: options.mockUrl ? 'polymarket:mock' : 'polymarket:clob',
+    source,
     count: mapped.length,
     items: mapped,
+    diagnostics,
   };
 }
 
 module.exports = {
   DEFAULT_POLYMARKET_HOST,
+  DEFAULT_POLYMARKET_GAMMA_HOST,
   fetchPolymarketMarkets,
 };

package/cli/lib/scan_command_service.cjs

@@ -58,8 +58,10 @@ function createRunScanCommand(deps) {
     const indexerUrl = resolveIndexerUrl(shared.indexerUrl);
 
     const options = parseMarketsListFlags(shared.rest);
+    options.expand = true;
     options.withOdds = true;
 
+    let hedgeableDiagnostics = [];
     let { items, pageInfo, unfilteredCount } = await fetchMarketsListPage(indexerUrl, options, shared.timeoutMs);
     if (options.hedgeable && typeof filterHedgeableMarkets === 'function') {
       const filtered = await filterHedgeableMarkets({
@@ -72,6 +74,9 @@ function createRunScanCommand(deps) {
       if (typeof filtered.unfilteredCount === 'number') {
         unfilteredCount = filtered.unfilteredCount;
       }
+      if (Array.isArray(filtered && filtered.diagnostics)) {
+        hedgeableDiagnostics = filtered.diagnostics;
+      }
     }
     const enrichmentContext = await buildMarketsEnrichmentContext(indexerUrl, items, options, shared.timeoutMs);
     const payload = buildMarketsListPayload(indexerUrl, options, items, pageInfo, {
@@ -79,6 +84,7 @@ function createRunScanCommand(deps) {
       scanMode: true,
       enrichmentContext,
       unfilteredCount,
+      externalDiagnostics: hedgeableDiagnostics,
     });
 
     emitSuccess(context.outputMode, 'scan', payload, renderScanTable);