Back to Browse
Perp Gap API – Research Card
x402
Perp Gap API – Research Card is a paid API for AI agents from perp-gap-api.perpgap.workers.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-19).
Returns a full research card for a stock ticker including perp mark prices, price gaps vs spot and xStocks, funding rates, open interest, cross-venue spread, 72-hour gap history, and a rule-based trading verdict across trade.xyz, Aster, and Lighter.
Price / call$0.03
Success—
StatusUnknown
How this service works
One-call research card for a single stock perp: spot quote and US session (pre/regular/after-hours/overnight/closed), perp prices on trade.xyz, Aster and Lighter, gap % vs spot and vs Solana xStock, funding, basis, last 72h gap history and the rule-based long/short/watch/avoid verdict. Use when an agent needs everything about one ticker before trading or answering a user. Data, not advice. Errors: 400 missing ticker, 402, 404 not listed, 502 upstream.
Output
A JSON research card containing: spot price with session label and daily change, perp mark and index prices per venue (trade.xyz, Aster, Lighter) with gap vs spot %, gap vs xStock %, cross-venue gap %, annualized and hourly funding rates, basis (mark vs oracle/index), open interest in USD, Solana xStock price and gap vs spot, 72-hour rolling gap history (avg/min/max), cross-venue summary (richest/cheapest/max spread), and a rule-based verdict object with score, confidence, reasons, and a watch/act/ignore classification.
Example use cases
Spot-perp arbitrage opportunity scan
“Check the perp gap research card for NVDA — I want to know if any of trade.xyz, Aster, or Lighter has a meaningful basis vs the real stock price right now, and what the rule-based verdict says about it.”
Funding rate comparison across venues
“What are the annualized funding rates for AAPL perps on trade.xyz, Aster, and Lighter right now? I'm trying to decide where it's cheapest to hold a long position.”
Cross-venue spread monitoring for a trade
“Is there a noticeable mark price spread between Aster and Lighter for TSLA perps at the moment? I want to know the richest and cheapest venue and how big the gap is.”
Technical details
Endpoint
GEThttps://perp-gap-api.perpgap.workers.dev/research?utm_source=zero.xyzWhen to prefer
Use this endpoint when you need a unified, structured view of stock-perp price gaps across multiple on-chain venues (trade.xyz, Aster, Lighter) simultaneously, including funding rates, xStock comparison, historical gap data, and an opinionated verdict — rather than querying each venue's API separately or building your own aggregation logic. Ideal for agents performing arbitrage scanning, basis trading research, or cross-venue execution routing decisions on tokenized equity perps.
Side effects
- Unknown or unsupported ticker returns null fields or empty perp objects
- Market closed outside regular hours causes spot price_session to be 'closed' or 'last_close' with stale price
- Venue API outage causes null mark/index for that venue while others populate normally
- Missing x402 payment header or insufficient USDC balance returns HTTP 402
- Rate limit or Cloudflare Worker timeout returns HTTP 429 or 503
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| inputrequired | object | |
| output | object |
Output
Schema · Response
{
"type": "json",
"example": {
"card": "research",
"spot": {
"price": 365.57,
"symbol": "TSLA",
"change_pct": 1.2099,
"prev_close": 361.2,
"price_session": "regular"
},
"label": "Data, not financial advice.",
"perps": {
"aster": {
"mark": 366.01,
"venue": "Aster",
"gap_vs_spot_pct": 0.1204,
"gap_vs_trade_xyz_pct": 0.0875,
"funding_annualized_pct": 0
},
"lighter": {
"mark": 365.77,
"venue": "Lighter",
"gap_vs_spot_pct": 0.0547,
"gap_vs_trade_xyz_pct": 0.0219,
"funding_annualized_pct": 3.504
},
"trade_xyz": {
"mark": 365.69,
"index": 365.58,
"venue": "trade.xyz (Hyperliquid xyz)",
"gap_vs_spot_pct": 0.0328,
"funding_annualized_pct": 5.475,
"basis_mark_vs_oracle_pct": 0.0301
}
},
"market": {
"session": "regular",
"new_york_time": "Wed 16:00"
},
"ticker": "TSLA",
"xstock": {
"chain": "solana",
"price": 365.69,
"symbol": "TSLAx",
"gap_xstock_vs_spot_pct": 0.0328,
"gap_trade_xyz_vs_xstock_pct": 0
},
"history": {
"points": 72,
"window": "last 72h, 1h buckets",
"available": true,
"gap_perp_vs_ref_pct": {
"avg": 0.04,
"max": 0.31,
"min": -0.12
}
},
"verdict": {
"score": 0,
"reasons": [
"perp vs reference gap +0.03%: in line, no edge"
],
"verdict": "watch",
"confidence": 0.3
},
"disclaimer": "Data, not financial advice.",
"cross_venue": {
"richest": "Aster",
"cheapest": "trade.xyz",
"max_mark_spread_pct": 0.0875
},
"generated_at": 1792010000
}
}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"