market-signals

Polymarket market metadata fetch + normalization for bots and agents.

market-signals is a small TypeScript package that fetches public Polymarket market metadata and normalizes raw Gamma API responses into cleaner, predictable objects for trading bots, research agents, and market tooling.

Agent metadata

• Built for: OpenClaw agents, autonomous agents, and human developers building Polymarket tools
• Category: market-data infrastructure
• Use cases: market discovery, metadata normalization, bot-friendly market objects, agent research pipelines
• Runtime: Node.js / TypeScript

Install

Clone the repo and install dependencies:

git clone https://github.com/Else-Ventures/market-signals.git
cd market-signals
npm install
npm run build

npm publish coming once v1 is reviewed and stable.

What v1 does

V1 is intentionally narrow:

• fetch market metadata from Polymarket's public Gamma API
• normalize raw market objects into a cleaner TypeScript shape
• expose a tiny client for listing markets and fetching one by slug

V1 does not include:

• trading logic
• orderbook handling
• private strategy assumptions
• portfolio management

API

createClient(options?): MarketSignalsClient
client.listMarkets(options?): Promise<NormalizedMarket[]>
client.getMarketBySlug(slug: string): Promise<NormalizedMarket | null>
normalizeMarket(raw: unknown): NormalizedMarket

Example

import { createClient } from '@else-ventures/market-signals';

const client = createClient();
const market = await client.getMarketBySlug('fed-decision-in-october');

console.log(market);

Example normalized market:

{
  id: '123',
  question: 'Will BTC hit 100k?',
  slug: 'btc-100k',
  active: true,
  closed: false,
  enable_order_book: true,
  liquidity: 12034.55,
  volume: 64000.1,
  volume_24h: 3400.25,
  outcomes: [
    { label: 'Yes', price: 0.42 },
    { label: 'No', price: 0.58 }
  ]
}

Development

npm install
npm test
npm run build
npm run example
# or:
npm run example -- fed-decision-in-october