# API Resources Runtime Plan

`api-resources/provider_capabilities_v4.json` is the primary provider capability catalog.

`api-resources/crypto_resources_unified_2025-11-11.json` is retained as the extended registry/reference.

`api-resources/ultimate_crypto_pipeline_2025_NZasinich.json` has been normalized to valid JSON by removing the preserved filename prefix line.

Runtime logic uses provider adapters under `providers/` and exposes catalog validation through:

```bash
GET /api/short-hunter/catalog
GET /api/short-hunter/health
```

Provider rotation can be tuned with environment variables:

- `SH_PROVIDER_ORDER_UNIVERSE`
- `SH_PROVIDER_ORDER_CONTRACT`
- `SH_PROVIDER_ORDER_TICKER`
- `SH_PROVIDER_ORDER_OHLCV`
- `SH_PROVIDER_ORDER_ORDERBOOK`
- `SH_PROVIDER_ORDER_FUNDING`
- `SH_PROVIDER_ORDER_OPEN_INTEREST`
- `SH_PROVIDER_ORDER_MARK_INDEX`
- `SH_PROVIDER_ORDER_SENTIMENT`

Example:

```bash
SH_PROVIDER_ORDER_TICKER=kucoin,binance,coingecko,cryptocompare
```

For exchange region/DNS issues, use provider base URL overrides or proxy variables instead of trying to mutate host DNS from the Space:

- `KUCOIN_FUTURES_BASE_URL`
- `BINANCE_FUTURES_BASE_URL`
- `HTTP_PROXY`
- `HTTPS_PROXY`
- `ALL_PROXY`