# Realedger Tokenized ETF Pre-Trade Gate

> Realedger Tokenized ETF Pre-Trade Gate is a paid API for AI agents from api.realedger.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Checks whether a tokenized ETF (USO, SPY, QQQ, GLD, SLV on Robinhood Chain) is currently tracking its reference price within acceptable bounds, returning on-chain price, basis, pool depth, oracle freshness, and risk flags.

## Facts

- Endpoint: POST https://api.realedger.xyz/v1/gate/:symbol
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/realedger-tokenized-etf-pre-trade-gate-3de20980
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NwSfdsaWAEpDlXQRBdt_s

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 realedger-tokenized-etf-pre-trade-gate-3de20980 -d '<json body>'
```

Example prompt: Before I swap into tokenized SPY on Robinhood Chain, check if it's currently tracking its reference price — tell me the basis, whether the pool is deep enough, and if there are any stale oracle or off-band flags I should know about.

## When to prefer this

Use this endpoint when you need a lightweight, real-time pre-trade sanity check specifically for tokenized ETFs (USO, SPY, QQQ, GLD, SLV) on Robinhood Chain. At $0.01 per call, it is designed to be polled frequently. Prefer this over the broader Realedger Basis Ledger endpoint when you only need a go/no-go signal and risk flags for a single symbol rather than a full comparative table.

## Known failure modes

- Invalid or unsupported ticker symbol returns an error — only USO, SPY, QQQ, GLD, SLV are supported
- Payment failure (missing or invalid USDC payment) results in 402 response
- Stale oracle data may be returned if the oracle itself is lagging — indicated by the stale_oracle flag rather than an error
- No pool exists for the symbol — no_pool flag is set and pool depth is zero
- Network or chain read failure may result in stale_read flag being set

## How this service works

Pre-trade gate, one cent, built to be polled: is the tokenized ETF (USO, SPY, QQQ, GLD, SLV on Robinhood Chain) tracking its reference right now? On chain price, expected off hours price, basis, band, pool depth in USD, read age, oracle age, fund session state, and flags: off_band, thin_pool, stale_read, stale_oracle, no_pool.

## Output

Returns current on-chain price, expected off-hours reference price, basis (spread between on-chain and reference), price band boundaries, pool depth in USD, age of last on-chain read, oracle data age, fund session state (open/closed/off-hours), and boolean risk flags: off_band, thin_pool, stale_read, stale_oracle, no_pool.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/realedger-tokenized-etf-pre-trade-gate-3de20980/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.realedger.xyz](https://www.zero.xyz/host/api.realedger.xyz/llms.txt)