Jupiter Prediction Skill v1.0
Purpose
Enable AI agents to interact with Jupiter Prediction Market API for autonomous trading and portfolio management.
When to Use
- - Build autonomous trading bots or agents
- Query market data, events, and user positions
- Create automated market scanning and opportunity detection
- Monitor portfolio health and risk
- Claim payouts after market settlement
Scope
- - Read/write access to Jupiter Prediction API
- Requires API key from Jupiter Portal
- All transactions require user signature via Solana wallet
- Beta API - subject to breaking changes
Quick Start
CODEBLOCK0
Configuration
CODEBLOCK1
Or use config file config/api-key.json.
Supported Capabilities
Client Endpoints
| Category | Methods |
|---|
| Events | INLINECODE1 , search, getEvent, INLINECODE4 |
| Markets |
getMarket,
orderbook |
| Orders |
create,
listOrders,
status,
cancelOrder |
| Positions |
listPositions,
getPosition,
closePosition,
closeAllPositions,
claim |
| History |
listHistory,
getHistoryByPosition |
| Social |
profile,
pnlHistory,
trades,
leaderboards,
follow/unfollow |
Utility Functions
| Function | Description |
|---|
| INLINECODE23 | Convert micro USD to USD |
| INLINECODE24 |
Format as currency string |
|
calculateProbability(yesPrice) | Implied probability (%) |
|
parseEventsResponse(response) | Parse event data |
|
parseMarketResponse(market) | Parse market data |
|
parsePositionsResponse(response) | Parse position data |
|
filterClaimable(positions) | Filter claimable positions |
|
filterOpen(positions) | Filter open positions |
|
aggregatePnL(positions) | Calculate total P&L |
Bundled Scripts
Run from project root:
CODEBLOCK2
Bundled Workflows
The bundled scripts provide complete autonomous agent workflows:
- 1. Market Scanner - Find markets by volume, probability, category
- Opportunity Finder - Detect mispriced markets
- Portfolio Monitor - Track positions, P&L, claimable
- Auto-Claim - Batch claim winnings
- Portfolio Health - Risk checks (position limits, diversification)
- Trading Cycle - Complete discovery → evaluation → execution
Code Examples
See src/ for available endpoints and utilities:
- -
src/client.js - Main API client class - INLINECODE34 - Exports and utility functions
- INLINECODE35 - Individual endpoint modules
- INLINECODE36 - Helper functions (parser, prices, errors)
API Reference
Client methods are documented in code comments. Main classes:
- -
JupiterPrediction - Main client (src/client.js) - Utility functions in src/index.js
Verification
Verify syntax:
CODEBLOCK3
Run a script (requires JUPITERAPIKEY):
CODEBLOCK4
Version
License
MIT
技能名称: jupiter-prediction-market
详细描述:
Jupiter 预测技能 v1.0
目的
使AI代理能够与Jupiter预测市场API交互，实现自主交易和投资组合管理。
使用场景
- - 构建自主交易机器人或代理
- 查询市场数据、事件和用户持仓
- 创建自动化市场扫描和机会检测
- 监控投资组合健康状况和风险
- 市场结算后领取收益
范围
- - 对Jupiter预测API的读写权限
- 需要从Jupiter门户获取API密钥
- 所有交易需通过Solana钱包进行用户签名
- Beta版API - 可能发生重大变更
快速开始
javascript
const { JupiterPrediction, parseEventsResponse, formatUsd } = require(./src);
const client = new JupiterPrediction();
const events = await client.list({ category: crypto, filter: trending, limit: 5 });
const parsed = parseEventsResponse(events);
console.log(事件:, parsed.data.map(e => e.title));
配置
bash
export JUPITERAPIKEY=你的API密钥
或使用配置文件 config/api-key.json。
支持的功能
客户端端点
| 类别 | 方法 |
|---|
| 事件 | list, search, getEvent, suggested |
| 市场 |
getMarket, orderbook |
| 订单 | create, listOrders, status, cancelOrder |
| 持仓 | listPositions, getPosition, closePosition, closeAllPositions, claim |
| 历史 | listHistory, getHistoryByPosition |
| 社交 | profile, pnlHistory, trades, leaderboards, follow/unfollow |
工具函数
| 函数 | 描述 |
|---|
| microUsdToUsd(microUsd) | 将微美元转换为美元 |
| formatUsd(microUsd, decimals) |
格式化为货币字符串 |
| calculateProbability(yesPrice) | 隐含概率（%） |
| parseEventsResponse(response) | 解析事件数据 |
| parseMarketResponse(market) | 解析市场数据 |
| parsePositionsResponse(response) | 解析持仓数据 |
| filterClaimable(positions) | 筛选可领取的持仓 |
| filterOpen(positions) | 筛选未平仓持仓 |
| aggregatePnL(positions) | 计算总盈亏 |
捆绑脚本
从项目根目录运行：
bash
按条件扫描市场
node scripts/scan-markets.js --crypto --limit=10 --min-volume=10000
寻找错误定价机会
node scripts/find-opportunities.js --threshold=20 --min-volume=50000
监控投资组合
node scripts/monitor-portfolio.js <钱包地址>
自动领取收益
node scripts/auto-claim.js <钱包地址> [--dry-run] [--min=1]
投资组合健康检查
node scripts/portfolio-health.js <钱包地址>
捆绑工作流
捆绑脚本提供完整的自主代理工作流：
- 1. 市场扫描器 - 按成交量、概率、类别查找市场
- 机会发现器 - 检测错误定价的市场
- 投资组合监控器 - 跟踪持仓、盈亏、可领取项
- 自动领取 - 批量领取收益
- 投资组合健康 - 风险检查（持仓限制、分散化）
- 交易周期 - 完整的发现→评估→执行流程
代码示例
查看 src/ 获取可用端点和工具：
- - src/client.js - 主API客户端类
- src/index.js - 导出和工具函数
- src/endpoints/ - 各端点模块
- src/utils/ - 辅助函数（解析器、价格、错误处理）
API参考
客户端方法在代码注释中有文档说明。主要类：
- - JupiterPrediction - 主客户端（src/client.js）
- src/index.js中的工具函数
验证
验证语法：
bash
node --check src/index.js
node --check src/client.js
运行脚本（需要JUPITERAPIKEY）：
bash
export JUPITERAPIKEY=你的密钥
node scripts/scan-markets.js --crypto --limit=5
版本
许可证
MIT
