# Futures Position Size Calculator

> Futures Position Size Calculator 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).

Calculates the number of futures contracts that fit within a given risk budget based on a stop distance expressed in ticks or points, returning contract count and risk per contract.

## Facts

- Endpoint: GET https://filings-specs-api.onrender.com/v1/position-size?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-position-size-calculator-6af41237
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WXetqACAbi59uZPZ_DUYe

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-position-size-calculator-6af41237
```

Example prompt: How many ES contracts can I trade if my risk budget is $500 and my stop is 8 ticks?

## When to prefer this

Use this endpoint when you need to calculate how many futures contracts to trade based on a fixed dollar risk budget and a known stop distance. It handles tick-to-dollar conversion internally using contract specifications, making it faster than manually looking up tick values and computing manually. Prefer this over a general position sizing formula when working with named futures symbols (ES, NQ, CL, GC, BTC, etc.) where tick/point values differ by product.

## Known failure modes

- Missing required 'symbol' or 'risk' query parameters returns an error
- Neither 'stop_ticks' nor 'stop_points' provided causes a calculation error
- Unsupported futures symbol returns a not-found or validation error
- Zero or negative stop distance causes a division error
- Non-numeric risk or stop values return a validation error

## How this service works

Calculates how many futures contracts fit a risk budget for a given stop distance (ticks or points), rounded down, with risk per contract.

## Output

Returns the number of futures contracts (rounded down) that fit within the specified risk budget given the stop distance, along with the risk per contract in the contract's native currency.

## 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",
      "risk"
     ],
     "properties": {
      "risk": {
       "type": "string",
       "description": "Risk budget in contract currency"
      },
      "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"
      },
      "stop_ticks": {
       "type": "string",
       "description": "Stop distance in ticks"
      },
      "stop_points": {
       "type": "string",
       "description": "Stop distance in points"
      }
     }
    }
   },
   "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-position-size-calculator-6af41237/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)