Back to Browse
PerpGap Historical Price Gap API
x402
PerpGap Historical Price Gap API is a paid API for AI agents from perp-gap-api.perpgap.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-19).
Returns historical time-series data on price gaps between stock perpetual futures (trade.xyz, Aster, Lighter) and reference stock prices or Solana xStocks, including funding rates, OI, and basis metrics
Price / call$0.02
Success—
StatusUnknown
How this service works
Pay-per-call API for AI agents: stock-perp price gaps across trade.xyz, Aster and Lighter vs the real stock and Solana xStocks, plus funding, basis, OI, research cards, history and rule-based verdicts. x402, USDC on Base or Solana.
Output
Returns a JSON array of time-series rows for the requested ticker and date range. Each row includes timestamps, perp mark prices from trade.xyz/Aster/Lighter, reference stock price, xStock price, hourly and annualized funding rates, open interest in USD, and percentage gap metrics between each exchange pair and versus the reference stock. Also returns count, ticker, interval, and a disclaimer.
Example use cases
Weekly arbitrage opportunity review
“Show me the hourly gap history for TSLA perps versus the real stock price and xStock from last Monday through Sunday, so I can see when the biggest arbitrage windows opened up.”
Funding rate trend analysis
“Pull the daily funding rate history for NVDA perps over the past 30 days across trade.xyz, Aster, and Lighter — I want to see the annualized rates and how they've trended.”
Exchange spread comparison over time
“Give me a week of hourly data on the price spread between Aster and trade.xyz for AAPL perps, including the max mark spread and basis vs oracle for each snapshot.”
Technical details
Endpoint
GEThttps://perp-gap-api.perpgap.workers.dev/history?utm_source=zero.xyzWhen to prefer
Use this endpoint when you need time-series historical data on stock perpetual price gaps across decentralized exchanges (trade.xyz, Aster, Lighter) versus real stock prices or Solana xStocks. Prefer this over real-time snapshot endpoints when trend analysis, backtesting, or funding rate history over a date range is the goal. Ideal for arbitrage research, basis trading analysis, and on-chain synthetic stock monitoring across multiple DeFi venues.
Side effects
- Invalid or unsupported ticker symbol returns an error or empty rows
- Date range too wide may result in truncated or paginated data
- Payment failure (x402) if USDC balance is insufficient on Base or Solana
- Missing required fields (ticker, from, to) returns a validation error
- Interval value not supported returns an error
- Data unavailable for non-market hours may return sparse rows
Output
Schema · Response
{
"type": "json",
"example": {
"to": "2026-10-14T20:00:00.000Z",
"from": "2026-10-07T00:00:00.000Z",
"rows": [
{
"ts": 1792008000,
"time": "2026-10-14T20:00:00.000Z",
"source": "snapshot",
"ticker": "TSLA",
"perp_mark": 365.69,
"ref_price": 365.57,
"aster_mark": 366.01,
"perp_oracle": 365.58,
"ref_session": "regular",
"lighter_mark": 365.77,
"xstock_price": 365.69,
"funding_hourly": 0.00000625,
"open_interest_usd": 42087597,
"gap_perp_vs_ref_pct": 0.0328,
"max_mark_spread_pct": 0.0875,
"aster_funding_hourly": 0,
"gap_aster_vs_xyz_pct": 0.0875,
"funding_annualized_pct": 5.475,
"gap_lighter_vs_xyz_pct": 0.0219,
"gap_perp_vs_xstock_pct": 0,
"lighter_funding_hourly": 0.000004,
"basis_mark_vs_oracle_pct": 0.0301
}
],
"count": 1,
"ticker": "TSLA",
"interval": "1h",
"disclaimer": "Data, not financial advice."
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"