{"uid":"cap_JxZiHHxZJ82mWKM5wfo4k","slug":"perp-gap-api-stock-perpetual-arbitrage-verdict-e32fd137","name":"Perp Gap API – Stock Perpetual Arbitrage Verdict","description":"Rule-based long/short/watch/avoid verdict with score, confidence and reasons for one trade.xyz stock perp, combining perp-vs-stock gap, basis, funding, SEC EDGAR insider/8-K/13D/dilution filings (14d), news and retail attention. Use when an agent needs a quick directional signal or a sanity check on a single ticker before trading. Data, not financial advice. Errors: 400 missing ticker, 402 payment required, 404 not listed, 502 upstream.","url":"https://perp-gap-api.perpgap.workers.dev/verdict?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["ticker"],"properties":{"ticker":{"type":"string","pattern":"^[A-Za-z0-9.]{1,10}$","examples":["TSLA","NVDA","GME"],"description":"One US stock ticker listed as a trade.xyz perp (see free GET /tickers), case-insensitive."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["ticker","verdict","confidence","disclaimer"],"properties":{"score":{"type":"number"},"inputs":{"type":"object"},"ticker":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}},"verdict":{"enum":["long","short","watch","avoid"],"type":"string"},"confidence":{"type":"number"},"disclaimer":{"type":"string"},"missing_signals":{"type":"array","items":{"type":"string"}}},"description":"Error responses are JSON {error: string}: 400 ticker required; 402 payment required; 404 ticker not listed on trade.xyz; 502 upstream error."}}}}},"responseSchema":{"type":"json","example":{"score":0.5,"ticker":"GME","reasons":["perp vs reference gap +0.09%: in line, no edge","funding 35.7% APR: crowded longs pay, short-lean","insider open-market buys $40,113,538 vs sells $870,659 (14d): bullish"],"verdict":"watch","confidence":0.4,"disclaimer":"Data, not financial advice.","missing_signals":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lqaAVGhZWktlzwa10I1Dj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a rule-based long/short/watch/avoid verdict for a stock ticker based on perp-vs-spot price gaps, funding rates, basis, open interest, and insider data across DeFi perp venues.","exampleAgentPrompt":"Give me a verdict on GME right now — check the perp-vs-spot gaps across trade.xyz, Aster and Lighter, funding rates, and insider activity, and tell me whether to long, short, watch, or avoid.","exampleUseCases":[{"title":"Pre-trade perp arbitrage check","prompt":"Before I open a TSLA position, can you check the perp gap signal — look at funding, basis, open interest and insider flows and tell me whether the verdict is long, short, watch or avoid, with a confidence score?"},{"title":"DeFi perp funding rate alert","prompt":"Is NVDA perp funding rate on DeFi venues showing a crowded trade right now? Give me the verdict and the reasons behind it."},{"title":"Retail meme stock perp analysis","prompt":"GME is moving a lot today — what does the perp market say? I want to see the gap between the perp price and real stock price, the funding APR, and whether the verdict is to go long or short."}],"resultDescription":"A JSON object containing: the ticker, a rule-based verdict enum (long/short/watch/avoid), a numeric score (0–1), a confidence value (0–1), an array of human-readable reasons explaining the signal inputs (perp gap %, funding APR, insider activity etc.), a list of any missing signals, and a disclaimer string.","failureModes":["Missing or invalid ticker returns an error — ticker must be a recognized symbol like TSLA or GME","Venue data unavailable: if trade.xyz, Aster or Lighter data is missing, affected signals appear in missing_signals array","Low confidence verdicts returned when insufficient signals are available (confidence near 0)","Payment failure via x402 protocol results in 402 response before data is returned","Rate or liquidity data may be stale for thinly traded perp markets"],"whenToPreferThis":"Choose this endpoint when you need a fast, structured trading signal that synthesizes DeFi perpetual futures data (price gaps, funding, basis, OI) with traditional equity signals (insider transactions, reference price) for a single stock ticker. It is especially useful for agents operating in the onchain perp arbitrage space across trade.xyz, Aster, and Lighter. It is not suited for pure spot equity analysis, options, or bulk batch screening.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T06:30:37.334Z","isFirstParty":false,"canonicalSlug":"perp-gap-api-stock-perpetual-arbitrage-verdict-e32fd137"}