Metadata-Version: 2.4
Name: astro-intelligence
Version: 0.1.0
Summary: Python client for the A.S.T.R.O. financial cognition engine API
Home-page: https://astro-event-horizon.vercel.app
Author: ASTRO Intelligence
Author-email: jarvisways@gmail.com
Project-URL: GitHub, https://github.com/jarvisways-cyber/astro-oracle
Project-URL: API Docs, https://astro-event-horizon.vercel.app/docs
Keywords: crypto,trading,oracle,market intelligence,algotrading,bitcoin,api,prediction markets,quantitative,signals
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: project-url
Dynamic: requires-python
Dynamic: summary

# A.S.T.R.O.
### Asset Sentiment Trend Risk Oracle

> *Not a signal. A translation of the market itself.*

---

A.S.T.R.O. is not a signal service. It is a financial cognition engine designed to translate the world's fragmented market data into a unified probability framework for digital assets.

At its core is a proprietary multi-dimensional oracle architecture that continuously ingests and interprets live global market intelligence across nine independent signal domains. Each layer is processed through an intellectual reaction stack that models how institutional algorithms, market makers, liquidity providers, retail participants, and autonomous trading systems are likely to respond under current conditions.

Rather than measuring what the market is doing, A.S.T.R.O. measures what the market is likely to do next.

---

## The Nine Signal Domains

**1. Fear & Greed Regimes**
Real-time market sentiment indexed and translated into a directional probability score.

**2. Market Structure Dynamics**
Bitcoin dominance, 24-hour market change, and structural position analysis synthesized into a single structural health score.

**3. Funding Rate Distortions**
Perpetual futures funding rates across seven assets on Kraken Futures, converted into a composite pressure score revealing whether the market is overleveraged long or short.

**4. Liquidity Pressure Mapping**
Live order book depth analysis across seven trading pairs — bid/ask ratio mapping that reveals where capital is positioned and where it is likely to move.

**5. Macro Correlation Networks**
Real-time correlation tracking across DXY (dollar index), QQQ (tech equity), VIX (volatility index), and GLD (gold) — quantifying macro tailwinds and headwinds against crypto capital flows.

**6. On-Chain Capital Flows**
Bitcoin mempool size, trade volume, and transactions-per-second monitored via Blockchain.info — revealing whether capital is accumulating, transacting, or withdrawing from the network.

**7. Derivatives & Options Positioning**
Deribit options flow analysis including put/call ratio, implied volatility skew, and max pain levels across BTC and ETH — decoding how institutional options desks are positioned.

**8. Narrative & Sentiment Velocity**
CoinGecko community data and trending asset analysis — measuring the velocity at which narrative is shifting across the crypto ecosystem.

**9. Congressional Insider Activity & Smart Capital Monitoring**
30-day composite congressional trading signal via Kadoa MIT monitor — whale-weighted tracking of smart capital flows from informed institutional actors.

---

## Ascendancy & Velocity

At the heart of A.S.T.R.O.'s per-asset intelligence is a proprietary scoring layer built on top of live prediction market data.

Every cycle, the engine scans up to 300 active prediction markets on **Polymarket** and **Kalshi** — platforms where real capital is staked on future outcomes. Each market question is classified against 15+ event categories including:

- Federal Reserve policy shifts
- SEC rulings and enforcement actions
- Crypto legislation and regulatory bills
- Exchange risk events
- Stablecoin stability signals
- Protocol upgrades
- Macro economic indicators
- Political and executive developments
- Crypto ban or restriction signals

Each event category carries **per-asset relevance weights**. An ETF approval signal scores BTC at maximum relevance and DOGE at minimal relevance. An SEC enforcement action scores ETH and SOL at high sensitivity while BTC absorbs it differently. Every asset responds to every event type according to its own calibrated sensitivity profile.

Markets are volume-weighted using a log10 normalization curve — a $5M prediction market carries significantly more weight than a $50K market, but no single market can dominate the output.

The result is the **Ascendancy Score** — a 0-100 probability-weighted measure of how favorably the prediction market intelligence landscape is positioned for each individual asset right now.

**Velocity** is the rate of change in Ascendancy between cycles — revealing whether conditions are accelerating toward an asset or retreating from it.

---

## Asset Gate Status

The engine synthesizes all nine signal domains into a continuous **Asset Gate Status** for each supported asset:

- `OPEN` — capital conditions favor entry consideration
- `BLOCKED` — structural, macro, or signal conditions do not support entry

Gate status incorporates SMA200 structural position, composite oracle score, ascendancy, velocity, and regime classification. When the gate is BLOCKED, the engine is protecting capital. When it opens, conditions have aligned across multiple independent domains simultaneously.

**Supported Assets**
Bitcoin · Ethereum · Solana · Cardano · Dogecoin · Chainlink · Polkadot · Polygon · Arbitrum · Optimism

---

## Live API Output

One API request every fifteen minutes delivers a complete strategic assessment:

```json
{
  "composite": 49.36,
  "regime": "NEUTRAL",
  "btc_price": 64250.10,
  "watching": [
    {"symbol": "SOL", "change_24h": 1.87},
    {"symbol": "DOGE", "change_24h": 1.22},
    {"symbol": "BTC", "change_24h": 0.91}
  ],
  "signals": {
    "fear_greed": 18.0,
    "market_structure": 48.03,
    "funding_rates": 52.29,
    "liquidity_pressure": 53.43,
    "macro_correlation": 54.5,
    "onchain_flows": 38.33,
    "options_flow": 48.83,
    "narrative_sentiment": 87.79,
    "congress_smart_money": 67.41
  },
  "last_updated": "2026-06-14T06:39:16Z"
}
```

Per-asset intelligence via `/oracle/assets`:

```json
{
  "BTC": {
    "ascendancy": 12.11,
    "velocity": 39.12,
    "sma200": 77641.76,
    "gate": "BLOCKED"
  },
  "SOL": {
    "ascendancy": 21.41,
    "velocity": -3.37,
    "sma200": 99.66,
    "gate": "BLOCKED"
  }
}
```

Historical cycle data via `/oracle/history` includes `outcome_1h` and `outcome_4h` — actual price movement recorded after each prediction cycle, building a continuously growing performance record.

---

## API Endpoints

| Endpoint | Description |
|----------|-------------|
| `/oracle/composite` | Full composite score + all 9 signals + top movers |
| `/oracle/signals` | Individual signal domain breakdown |
| `/oracle/assets` | Per-asset ascendancy, velocity, SMA200, gate status |
| `/oracle/congress` | Congressional smart money signal detail |
| `/oracle/history` | Historical oracle cycles with outcome tracking |

**Authentication:** `X-API-Key` header or `?api_key=` query parameter
**Rate limit:** 1 request per 15 minutes — synchronized with oracle cycle time

---

## Quick Start

```python
import requests

response = requests.get(
    "https://your-endpoint/oracle/composite",
    params={"api_key": "your-key"}
)

data = response.json()
print(f"Regime:    {data['regime']}")
print(f"Composite: {data['composite']}")
print(f"FNG:       {data['signals']['fear_greed']}")
print(f"Congress:  {data['signals']['congress_smart_money']}")
```

```javascript
const res = await fetch(
  `https://your-endpoint/oracle/assets?api_key=${API_KEY}`
);
const { assets } = await res.json();
Object.entries(assets).forEach(([symbol, data]) => {
  console.log(`${symbol}: gate=${data.gate} asc=${data.ascendancy} vel=${data.velocity}`);
});
```

---

## Access

**$9/month — Full access. All endpoints. All nine signals. All ten assets.**

[astro-event-horizon.vercel.app](https://astro-event-horizon.vercel.app)

API key delivered instantly to your email upon payment.

---

## System Status

- [x] 9-signal oracle architecture — live
- [x] Prediction market intelligence layer (Polymarket + Kalshi) — active
- [x] Per-asset ascendancy + velocity scoring — live
- [x] Continuous 15-minute oracle cycles — running
- [x] REST API with authentication and rate limiting — live
- [x] Outcome tracking (1h + 4h) — logging every cycle
- [x] Automated Stripe payment + instant key delivery — live
- [ ] Module 8: Self-optimizing weight layer — building (target: 2,000 cycles)

---

*For traders, funds, quantitative systems, and autonomous agents seeking an informational edge, A.S.T.R.O. functions as a market operating system — decoding the collective behavior of global capital in real time.*

*No charts to interpret. No indicators to configure. No noise.*
