Billing

Estimate request cost

Returns predicted cost before a request is made. Free to call, requires authentication. Used by AI agents for pre-flight cost checks.

post/estimate

Request

  • Base URL: https://riskmodels.app/api
  • URL: https://riskmodels.app/api/estimate
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://riskmodels.app/oauth/authorize, token URL https://riskmodels.app/api/oauth/token, scopes: mcp:read)

Request body

endpointstring required

Target endpoint (ticker-returns, batch-analyze, l3-decomposition, etc.)

paramsobject

Same params as the target endpoint

Example request

{
  "endpoint": "ticker-returns",
  "params": {
    "ticker": "AAPL",
    "years": 5
  }
}

Response

Cost estimate

estimated_cost_usdnumber float required
estimated_tokensinteger
estimated_rowsinteger

Estimated row count for time-series endpoints.

estimated_bytesinteger

Estimated response size in bytes.

capabilitystring required
pricing_model'per_request' | 'per_position' | 'per_token' | 'subscription' required
unit_cost_usdnumber float
min_chargenumber float
notestring required

Example response

{
  "estimated_cost_usd": 0.008,
  "estimated_tokens": 400,
  "capability": "ticker-returns",
  "note": "Actual cost may vary. Cached responses are free."
}

Changes

No recorded changes to this operation across all 1 revision of this API.