---
title: "Position size calculator with guardrail enforcement"
method: POST
path: "/v1/agent/futures/position-sizing"
tags: ["Strategy"]
---

# Position size calculator with guardrail enforcement

`POST /v1/agent/futures/position-sizing`

## Request

- Base URL: `https://www.farmdash.one/api`
- URL: `https://www.farmdash.one/api/v1/agent/futures/position-sizing`
- Auth: HTTP bearer

Given entry price, stop price, equity, and risk, returns exact position
size, leverage, and margin. All guardrails enforced server-side.
Pioneer+ required.

## Headers

- `X-ClawHub-Skill` string

## Request body

- PositionSizingRequest
  - `equity` number, required: Account equity in USD
  - `entryPrice` number, required
  - `stopPrice` number, required
  - `riskPercent` number: Capped at 2%
  - `targetPrice` number: For R:R calculation
  - `riskMultiplier` number: Optional flexibility modifier for risk tolerance. 1.0 keeps the full risk budget; lower values are more conservative.

## Response `200`

Position sizing result

- PositionSizingResponse
  - `ok` boolean
  - `sizing` PositionSizing
    - `positionSize` number
    - `positionValueUsd` number
    - `leverage` number
    - `marginRequired` number
    - `riskAmount` number
    - `riskPercent` number
    - `stopDistance` number
    - `rewardRiskRatio` number
  - `guardrails` object
    - `maxLeverage` integer
    - `maxRiskPerTrade` string
    - `maxPositionValue` string
    - `note` string
  - `timestamp` integer

## Other responses

- `400`: Invalid parameters
- `402`: Free-tier limit exceeded — x402 payment required

---

[API](https://skmtc.dev/farmdash/apis/farmdash-agent-api.md) · [All operations](https://skmtc.dev/farmdash/apis/farmdash-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/farmdash/apis/farmdash-agent-api/revisions/96310281f58c?raw)