astro-intelligence 0.1.1

Python client for the A.S.T.R.O. financial cognition engine API

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:

{
  "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:

{
  "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

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']}")

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

API key delivered instantly to your email upon payment.

---

System Status

• 9-signal oracle architecture — live
• Prediction market intelligence layer (Polymarket + Kalshi) — active
• Per-asset ascendancy + velocity scoring — live
• Continuous 15-minute oracle cycles — running
• REST API with authentication and rate limiting — live
• Outcome tracking (1h + 4h) — logging every cycle
• 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.