# LoneStarOracle FundingRates

> LoneStarOracle FundingRates is a paid API for AI agents from api.aidress.ai, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Returns perpetual futures funding rates across major exchanges (OKX, Hyperliquid, dYdX) for top crypto assets with signal analysis and AI market bias commentary

## Facts

- Endpoint: GET https://api.aidress.ai/pay/agent_funding_lonestaroracle_xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lonestaroracle-fundingrates-428b42b1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YjyWkmBxjtN3Crgl6IWsa

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability lonestaroracle-fundingrates-428b42b1
```

Example prompt: What's the current funding rate situation for BTC across all exchanges — is it LONG_HEAVY or SHORT_HEAVY, and what's the annualized rate and AI market bias?

## When to prefer this

Choose this endpoint when you need real-time perpetual futures funding rate data with pre-computed directional signals (LONG_HEAVY/SHORT_HEAVY/etc.) and AI narrative commentary, rather than raw exchange data that requires manual interpretation. Ideal for trading agents that need a quick signal-first answer about market positioning across multiple top-tier exchanges without integrating individually with OKX, Hyperliquid, and dYdX APIs. Best when 5-minute cached freshness is acceptable.

## Known failure modes

- Asset not supported — only BTC, ETH, SOL, AVAX, LINK, ARB are available; unsupported symbols return an error
- Payment failure — x402 payment of $0.05 USDC not processed correctly
- Exchange data unavailable — one or more upstream exchanges (OKX, Hyperliquid, dYdX) temporarily unreachable; partial data may be returned
- Rate limit or upstream timeout — cached data may be up to 5 minutes stale
- Invalid query parameter format — non-string or malformed asset parameter

## How this service works

Full funding rates — all assets, all exchanges, signal analysis

## Output

Returns a JSON object containing per-asset funding data including annualized rate percentage, 8-hour rate percentage, signal classification (LONG_HEAVY/SHORT_HEAVY/NEUTRAL/MIXED/EXTREME), per-exchange breakdown, an extreme alert flag, next settlement time, and an AI-generated market bias narrative summarizing current conditions.

## Request schema (JSON Schema)

```json
{
 "name": "LoneStarOracle — FundingRates",
 "tags": [
  "funding",
  "futures",
  "perps",
  "leverage",
  "crypto",
  "trading"
 ],
 "type": "object",
 "version": "1.0.0",
 "category": "crypto",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "asset": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ],
       "title": "Asset"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "rates": {
      "BTC": {
       "signal": "LONG_HEAVY",
       "annualized_pct": 21.9,
       "avg_rate_8h_pct": 0.02
      }
     },
     "signal": "LONG_HEAVY",
     "market_bias": "Longs overextended — BTC longs paying 22% annualized."
    }
   }
  }
 },
 "description": "Perp futures funding rates across OKX, Hyperliquid, dYdX for BTC/ETH/SOL/AVAX/LINK/ARB. Signal-first: LONG_HEAVY/SHORT_HEAVY/NEUTRAL/MIXED/EXTREME. Annualized rates, per-exchange breakdown, extreme alert, next settlement time, AI market bias. 5-min cache."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lonestaroracle-fundingrates-428b42b1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.aidress.ai](https://www.zero.xyz/host/api.aidress.ai/llms.txt)