{"_id":"@else-ventures/market-signals","name":"@else-ventures/market-signals","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@else-ventures/market-signals","version":"0.1.0","description":"Polymarket market metadata fetch + normalization for bots and agents","type":"module","main":"./dist/src/index.js","types":"./dist/src/index.d.ts","scripts":{"build":"tsc -p tsconfig.json","test":"vitest run","example":"tsx examples/fetch-market.ts"},"keywords":["openclaw","ai-agents","polymarket","prediction-markets","typescript"],"license":"MIT","devDependencies":{"@types/node":"^22.15.3","tsx":"^4.19.2","typescript":"^5.8.3","vitest":"^3.2.4","zod":"^3.24.3"},"gitHead":"f8d05d129de2ea9bb6519fc43b6de508d4094f1c","_id":"@else-ventures/market-signals@0.1.0","_nodeVersion":"24.13.1","_npmVersion":"11.8.0","dist":{"integrity":"sha512-uSTD4URrNfSYywH/hTDr1qK63qcmf41imee58BwhITBh3TMzOg5Wvg1n9K/n3x5v/7sV7a7yjWJ4/hAM61OKhQ==","shasum":"e354f9c36c0f370a3d2dbf3dca396a02590f9e51","tarball":"https://registry.npmjs.org/@else-ventures/market-signals/-/market-signals-0.1.0.tgz","fileCount":8,"unpackedSize":15195,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC+c9MxAe8rn4UTyhr1fZIAuhE2QdKhAsYABN9oRa7GpgIhANfjjhimcpt5OAEBLcIMWkcxvWwQSsPzA6/wKfkWdAG5"}]},"_npmUser":{"name":"elseventures","email":"elsie@else.ventures"},"directories":{},"maintainers":[{"name":"elseventures","email":"elsie@else.ventures"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/market-signals_0.1.0_1777048782514_0.2691459708301558"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-24T16:39:42.442Z","0.1.0":"2026-04-24T16:39:42.646Z","modified":"2026-04-24T16:39:42.841Z"},"maintainers":[{"name":"elseventures","email":"elsie@else.ventures"}],"description":"Polymarket market metadata fetch + normalization for bots and agents","keywords":["openclaw","ai-agents","polymarket","prediction-markets","typescript"],"license":"MIT","readme":"# market-signals\n\nPolymarket market metadata fetch + normalization for bots and agents.\n\n`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.\n\n## Agent metadata\n\n- Built for: OpenClaw agents, autonomous agents, and human developers building Polymarket tools\n- Category: market-data infrastructure\n- Use cases: market discovery, metadata normalization, bot-friendly market objects, agent research pipelines\n- Runtime: Node.js / TypeScript\n\n## Install\n\nClone the repo and install dependencies:\n\n```bash\ngit clone https://github.com/Else-Ventures/market-signals.git\ncd market-signals\nnpm install\nnpm run build\n```\n\nnpm publish coming once v1 is reviewed and stable.\n\n## What v1 does\n\nV1 is intentionally narrow:\n- fetch market metadata from Polymarket's public Gamma API\n- normalize raw market objects into a cleaner TypeScript shape\n- expose a tiny client for listing markets and fetching one by slug\n\nV1 does **not** include:\n- trading logic\n- orderbook handling\n- private strategy assumptions\n- portfolio management\n\n## API\n\n```ts\ncreateClient(options?): MarketSignalsClient\nclient.listMarkets(options?): Promise<NormalizedMarket[]>\nclient.getMarketBySlug(slug: string): Promise<NormalizedMarket | null>\nnormalizeMarket(raw: unknown): NormalizedMarket\n```\n\n## Example\n\n```ts\nimport { createClient } from '@else-ventures/market-signals';\n\nconst client = createClient();\nconst market = await client.getMarketBySlug('fed-decision-in-october');\n\nconsole.log(market);\n```\n\nExample normalized market:\n\n```ts\n{\n  id: '123',\n  question: 'Will BTC hit 100k?',\n  slug: 'btc-100k',\n  active: true,\n  closed: false,\n  enable_order_book: true,\n  liquidity: 12034.55,\n  volume: 64000.1,\n  volume_24h: 3400.25,\n  outcomes: [\n    { label: 'Yes', price: 0.42 },\n    { label: 'No', price: 0.58 }\n  ]\n}\n```\n\n## Development\n\n```bash\nnpm install\nnpm test\nnpm run build\nnpm run example\n# or:\nnpm run example -- fed-decision-in-october\n```\n","readmeFilename":"README.md","_rev":"1-07302df45179de9c0ac9576d32f46b56"}