> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aioka.io/llms.txt
> Use this file to discover all available pages before exploring further.

# SOL Live Signals

> Latest readings of all 7 SOL-specific signals plus the Solana network health probe (Gate 0)

<Note>
  Pro tier endpoint -- requires a valid Pro API key. Fetches fresh
  signal readings on every request (expect 1 -- 3 seconds response time).
</Note>

**Tier:** Pro (\$199/mo)
**Cache:** None -- fetches fresh on every request
**Rate limit:** 30/min (per tier)
**Read-only:** No writes.

## Response Fields

### Top-level

| Field           | Type           | Meaning                                                                                              |
| --------------- | -------------- | ---------------------------------------------------------------------------------------------------- |
| `signals`       | array          | Latest readings for each SOL signal, one entry per signal key                                        |
| `networkHealth` | string         | Gate 0 result: `"HEALTHY"` / `"DEGRADED"` / `"UNKNOWN"`. `DEGRADED` blocks all SOL entries.          |
| `networkTps`    | number \| null | Current Solana network throughput (TPS) from `getRecentPerformanceSamples`. `null` when probe fails. |
| `generatedAt`   | string         | Response timestamp (ISO 8601)                                                                        |

### Per-signal (signals array)

| Field       | Type           | Meaning                                                                    |
| ----------- | -------------- | -------------------------------------------------------------------------- |
| `key`       | string         | Signal identifier (see signal catalog below)                               |
| `value`     | number \| null | Latest numeric reading. `null` when the source is temporarily unavailable. |
| `direction` | string         | `"BULLISH"` / `"BEARISH"` / `"NEUTRAL"` / `"UNKNOWN"`                      |
| `source`    | string         | Data source identifier                                                     |
| `detail`    | string         | Human-readable description of the current reading                          |
| `fetchedAt` | string         | ISO 8601 timestamp of when this reading was captured                       |

## SOL Signal Catalog

All 7 SOL-specific signals feed the council deliberation every 30 minutes.
Signals are cached with a 60-second TTL to avoid hammering external APIs.

| Signal Key                  | Description                                                                                                                                           | Source                                            | Agent               |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- | ------------------- |
| `SOL_NETWORK_TPS`           | Current Solana network throughput (transactions per second). HEALTHY threshold: ≥ 1000 TPS.                                                           | Solana RPC `getRecentPerformanceSamples`          | NETWORK\_SENTINEL   |
| `SOL_NETWORK_HEALTH`        | Gate 0 network health label: `HEALTHY` / `DEGRADED`. Derived from TPS threshold + `status.solana.com` check. `DEGRADED` blocks all entries.           | Solana RPC + status.solana.com                    | NETWORK\_SENTINEL   |
| `SOL_DEFI_TVL_TREND`        | 7-day TVL trend on the Solana chain across all protocols (DeFiLlama Solana filter). Positive values = growing ecosystem liquidity.                    | DeFiLlama                                         | ECOSYSTEM\_ANALYST  |
| `SOL_STAKING_PARTICIPATION` | % of total SOL supply currently delegated to active validators. Higher = stronger network security signal.                                            | Solana Beach / validators.app (graceful fallback) | NETWORK\_SENTINEL   |
| `SOL_BTC_RATIO_TREND`       | SOL/BTC ratio 7-day trend direction. Positive = SOL outperforming BTC (alt-season momentum signal).                                                   | Internal (Kraken prices)                          | MOMENTUM\_HUNTER    |
| `SOL_FUNDING_RATE`          | Perpetual futures funding rate on Deribit `SOL_USDC-PERPETUAL`. Positive = longs paying (bullish sentiment), Negative = shorts paying (bearish bias). | Deribit                                           | LIQUIDITY\_GUARDIAN |
| `SOL_MEMECOIN_ACTIVITY`     | 7-day memecoin volume aggregate on Solana from DeFiLlama. High memecoin activity signals retail engagement and network fee revenue.                   | DeFiLlama                                         | ECOSYSTEM\_ANALYST  |

## Notes

* `SOL_NETWORK_HEALTH` and `SOL_NETWORK_TPS` are always fresh (60s probe
  cache) and duplicated in the top-level `networkHealth` / `networkTps`
  fields for convenience.
* `SOL_STAKING_PARTICIPATION` uses Solana Beach as the primary source and
  falls back to `validators.app` on timeout. Both may return `null` during
  maintenance windows.
* Deribit is used instead of Binance for `SOL_FUNDING_RATE` because Binance
  is geo-blocked on the Railway US deployment.

<RequestExample>
  ```bash curl theme={null}
  curl https://api.aioka.io/v1/sol/signals \
    -H "X-API-Key: aik_pro_your_key_here"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "signals": [
      {
        "key": "SOL_NETWORK_TPS",
        "value": 2850.5,
        "direction": "BULLISH",
        "source": "solana_rpc",
        "detail": "Network TPS 2850 -- well above HEALTHY threshold of 1000",
        "fetchedAt": "2026-05-06T10:29:45+00:00"
      },
      {
        "key": "SOL_NETWORK_HEALTH",
        "value": 1.0,
        "direction": "BULLISH",
        "source": "solana_rpc",
        "detail": "HEALTHY -- TPS 2850, status.solana.com nominal",
        "fetchedAt": "2026-05-06T10:29:45+00:00"
      },
      {
        "key": "SOL_DEFI_TVL_TREND",
        "value": 0.034,
        "direction": "BULLISH",
        "source": "defi_llama",
        "detail": "Solana DeFi TVL +3.4% over 7 days ($8.2B -> $8.48B)",
        "fetchedAt": "2026-05-06T10:25:00+00:00"
      },
      {
        "key": "SOL_STAKING_PARTICIPATION",
        "value": 0.681,
        "direction": "BULLISH",
        "source": "solana_beach",
        "detail": "68.1% of supply staked -- above 65% strong-participation threshold",
        "fetchedAt": "2026-05-06T10:25:00+00:00"
      },
      {
        "key": "SOL_BTC_RATIO_TREND",
        "value": 0.0021,
        "direction": "BULLISH",
        "source": "kraken",
        "detail": "SOL/BTC ratio +0.21% over 7 days -- mild SOL outperformance",
        "fetchedAt": "2026-05-06T10:29:30+00:00"
      },
      {
        "key": "SOL_FUNDING_RATE",
        "value": 0.00042,
        "direction": "BULLISH",
        "source": "deribit",
        "detail": "Funding rate +0.042% per 8h -- longs paying, mild bullish bias",
        "fetchedAt": "2026-05-06T10:28:00+00:00"
      },
      {
        "key": "SOL_MEMECOIN_ACTIVITY",
        "value": 142000000.0,
        "direction": "NEUTRAL",
        "source": "defi_llama",
        "detail": "7-day Solana memecoin volume $142M -- stable vs prior week",
        "fetchedAt": "2026-05-06T10:25:00+00:00"
      }
    ],
    "networkHealth": "HEALTHY",
    "networkTps": 2850.5,
    "generatedAt": "2026-05-06T10:30:00+00:00"
  }
  ```
</ResponseExample>
