Metadata-Version: 2.4
Name: falcon-jupiter-agent
Version: 0.2.4
Summary: Autonomous Jupiter Prediction Market agent — Solana execution, tethered to Falcon AI
Project-URL: Homepage, https://app.falconai.pro
Project-URL: Documentation, https://developers.jup.ag/docs/prediction
Project-URL: Agent setup (app), https://app.falconai.pro/app/jupiter/agents/client
Project-URL: Source, https://github.com/Falcon-AI-Pro/falcon-ai-client
Author: Falcon AI
License-Expression: MIT
Keywords: falcon,jupiter,prediction-markets,solana,trading-agent
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial :: Investment
Requires-Python: >=3.11
Requires-Dist: base58<3,>=2.1
Requires-Dist: colorlog<7,>=6.8
Requires-Dist: falcon-agent-webui>=0.1.0
Requires-Dist: flask-cors<6,>=4.0
Requires-Dist: flask<4,>=3.0
Requires-Dist: httpx<1,>=0.27
Requires-Dist: pydantic-settings<3,>=2.0
Requires-Dist: pydantic<3,>=2.0
Requires-Dist: python-dotenv<2,>=1.0
Requires-Dist: solana<1,>=0.34
Requires-Dist: solders<1,>=0.21
Requires-Dist: waitress<4,>=3.0
Requires-Dist: websockets<16,>=12.0
Provides-Extra: dev
Requires-Dist: build>=1.0; extra == 'dev'
Requires-Dist: hatchling>=1.24; extra == 'dev'
Requires-Dist: pytest<9,>=8.0; extra == 'dev'
Requires-Dist: twine>=5.0; extra == 'dev'
Description-Content-Type: text/markdown

# Falcon Jupiter Prediction Agent

Runs on your machine. Listens for Falcon `jupiter_prediction` signals over WebSocket and places orders on [Jupiter Prediction Markets](https://developers.jup.ag/docs/prediction) via local Solana signing.

## Quick start

```bash
cd client/falcon-jupiter-client
cp .env.example .env
# Edit FALCON_API_KEY, optional JUPITER__API_KEY and SOLANA__PRIVATE_KEY

pip install -e .
falcon-jupiter-agent-check
falcon-jupiter-agent
```

Or via npm bootstrap:

```bash
npx @falconai/agent-client jupiter
```

## Modes

- **DRY_RUN=true** (default) — logs intended trades to `logs/jupiter_trades.csv`
- **DRY_RUN=false** — creates Jupiter orders, signs transactions locally, submits to Solana RPC

Minimum order size on Jupiter is **$5**.

## WebSocket subscribe

The agent subscribes with `providers: ["jupiter_prediction"]` so Polymarket signals are ignored.

## Strategy sync

On startup, fetches active strategies from `GET /api/jupiter/client/strategies/active` (same API key).
