# Futures Contract Specification Lookup

> Futures Contract Specification Lookup is a paid API for AI agents from filings-specs-api.onrender.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-03).

Returns the contract specification (multiplier, tick size, tick value, point value, currency, trading hours) for a given futures symbol across major exchanges (CME, CBOT, NYMEX, COMEX, Cboe, Eurex).

## Facts

- Endpoint: GET https://filings-specs-api.onrender.com/v1/spec?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-03
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/futures-contract-specification-lookup-66feb483
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ty4Br0rXrxOqBHprXCAXr

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 futures-contract-specification-lookup-66feb483
```

Example prompt: What are the contract specs for ES futures — specifically the tick size, tick value, point value, and trading hours?

## When to prefer this

Use this endpoint when an agent needs the precise contract specifications for a futures symbol before calculating position size, dollar risk, or P&L — especially for any symbol traded on CME, CBOT, NYMEX, COMEX, Cboe, or Eurex. It is purpose-built for futures contract metadata and covers both standard and micro contracts across asset classes (equity indices, commodities, currencies, rates, crypto). Prefer this over general financial data APIs when you specifically need tick size, tick value, multiplier, and trading hours in a single call.

## Known failure modes

- Unknown or unsupported symbol returns an error or empty response
- Symbol provided in wrong format (e.g. expiry appended like ESH25) may not match
- Payment failure or missing x402 payment header results in 402 response
- Network timeout from the Render-hosted service under load

## How this service works

Returns the contract specification of a futures symbol (CME, CBOT, NYMEX, COMEX, Cboe, Eurex): multiplier, tick size, tick value, point value, currency and trading hours.

## Output

A JSON object containing the full contract specification for the requested futures symbol, including: multiplier (contract size), tick size (minimum price increment), tick value (dollar value of one tick), point value (dollar value of one full point), currency denomination, and trading hours for the exchange on which the contract is listed.

## Request schema (JSON Schema)

```json
{
 "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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "symbol"
     ],
     "properties": {
      "symbol": {
       "type": "string",
       "description": "Futures symbol, e.g. ES, MES, NQ, MNQ, YM, RTY, CL, MCL, NG, GC, MGC, SI, HG, ZT, ZF, ZN, ZB, 6E, 6J, 6B, 6S, BTC, MBT, ZC, ZS, ZW, VX, FDAX, FDXM, FDXS, FESX, FSMI, FGBL, FGBM, FGBS"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/futures-contract-specification-lookup-66feb483/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from filings-specs-api.onrender.com](https://www.zero.xyz/host/filings-specs-api.onrender.com/llms.txt)