{"slug":"perp-gap-api-perpgap-workers-dev-tokens-premium-311c77","title":"Use before buying or pricing a tokenized stock (NVDAx, NVDAon) to see if it trad","host":"perp-gap-api.perpgap.workers.dev","method":"GET","resource":"https://perp-gap-api.perpgap.workers.dev/tokens/premium","category":"market","description":"Use before buying or pricing a tokenized stock (NVDAx, NVDAon) to see if it trades rich or cheap vs the real share. For one ticker, up to 10, or tickers=all: each xStocks and Ondo Global Markets token's price per share vs the stock reference, premium %, Ondo issuer price, freshness, chain and pool l","price_listed":0.01,"price_asked":0.01,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":438,"reported_calls_30d":3,"reported_payers_30d":2,"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","queryParams":{"ticker":"NVDA"},"type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"method":{"enum":["GET"],"type":"string"},"queryParams":{"additionalProperties":false,"properties":{"ticker":{"description":"Stock ticker, case-insensitive (free list: GET /catalog).","examples":["NVDA"],"pattern":"^[A-Za-z0-9.]{1,12}$","type":"string"},"tickers":{"description":"Optional alternative to ticker: up to 10 comma-separated tickers, or 'all'.","type":"string"}},"required":["ticker"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"description":"Error responses are JSON {error: string, hint?: string}. 400 bad params (never charged); 402 payment required; 404 ticker/market not listed (checked before settlement, never charged); 502 upstream error. Full field docs: /openapi.json.","properties":{"as_of":{"type":"string"},"count":{"type":"number"},"disclaimer":{"type":"string"},"mode":{"type":"string"},"notes":{"type":"string"},"rows":{"type":"array"},"us_session":{"type":"string"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.01,"price_match":true,"latency_ms":438,"error":null}],"description_full":"Use before buying or pricing a tokenized stock (NVDAx, NVDAon) to see if it trades rich or cheap vs the real share. For one ticker, up to 10, or tickers=all: each xStocks and Ondo Global Markets token's price per share vs the stock reference, premium %, Ondo issuer price, freshness, chain and pool liquidity. Bad params return 400/404 before any charge. Errors: 400, 402, 404, 502. Data, not advice.","last_updated":"2026-10-23T07:13:41.896Z","schemes":["exact"]}