MyCoveredCall Proxy API

Stock & Options Market Data API

Overview

This API provides access to real-time stock prices, option chains, strikes, expirations, and option quotes through a single, secured endpoint.

Note: This API requires authentication using an API key. Contact the administrator to obtain your API key.

Base URL

https://api.mycoveredcall.com

Rate Limiting

Each API key has a rate limit defined in the system (default: 100 requests per minute). Rate limit information is included in response headers:

Authentication

All API requests must include an API key in the Authorization header using Bearer token authentication:

Authorization: Bearer YOUR_API_KEY

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.mycoveredcall.com/v1/quotes?symbol=AAPL

Endpoints

GET /v1/quotes

Get real-time stock price data for a given symbol.

Parameters

Parameter Type Required Description
symbol string Required Stock ticker symbol (e.g., AAPL, MSFT, TSLA)

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.mycoveredcall.com/v1/quotes?symbol=AAPL

Example Response

{
  "success": true,
  "data": {
    "symbol": "AAPL",
    "price": 150.25,
    "open": 149.50,
    "high": 151.00,
    "low": 149.00,
    "volume": 50000000,
    "previous_close": 148.75,
    "change": 1.50,
    "change_percent": 1.01,
    "timestamp": 1699564800,
    "cached": false
  },
  "timestamp": "2025-11-11T22:00:00+00:00"
}

GET /v1/options/chain

Get options chain data for a specific symbol and expiration date.

Parameters

Parameter Type Required Description
symbol string Required Stock ticker symbol
expiration string Required Expiration date (YYYY-MM-DD format)
strike_min number Optional Minimum strike price (default: 80% of stock price)
strike_max number Optional Maximum strike price (default: 120% of stock price)

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
     "https://api.mycoveredcall.com/v1/options/chain?symbol=AAPL&expiration=2025-01-17&strike_min=140&strike_max=160"

Example Response

{
  "success": true,
  "data": {
    "symbol": "AAPL",
    "stock_price": 150.25,
    "expiration": "2025-01-17",
    "strike_range": {
      "min": 140,
      "max": 160
    },
    "options": [
      {
        "details": {
          "ticker": "AAPL250117C00150000",
          "strike_price": 150,
          "expiration_date": "2025-01-17"
        },
        "last_quote": {
          "bid": 5.20,
          "ask": 5.40,
          "midpoint": 5.30
        },
        "day": {
          "volume": 1250
        },
        "open_interest": 5000,
        "implied_volatility": 0.25,
        "greeks": {
          "delta": 0.52
        }
      }
    ]
  },
  "metadata": {
    "count": 1,
    "timestamp": "2025-11-11T22:00:00+00:00"
  }
}

GET /v1/options/strikes

Get all available strike prices for a symbol's options.

Parameters

Parameter Type Required Description
symbol string Required Stock ticker symbol

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.mycoveredcall.com/v1/options/strikes?symbol=AAPL

Example Response

{
  "success": true,
  "data": {
    "symbol": "AAPL",
    "strikes": [140, 145, 150, 155, 160, 165, 170],
    "updated": 1699564800
  },
  "metadata": {
    "count": 7,
    "timestamp": "2025-11-11T22:00:00+00:00"
  }
}

GET /v1/options/expirations

Get all available expiration dates for a symbol's options.

Parameters

Parameter Type Required Description
symbol string Required Stock ticker symbol

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.mycoveredcall.com/v1/options/expirations?symbol=AAPL

Example Response

{
  "success": true,
  "data": {
    "symbol": "AAPL",
    "expirations": ["2025-01-17", "2025-02-21", "2025-03-21"],
    "updated": 1699564800
  },
  "metadata": {
    "count": 3,
    "timestamp": "2025-11-11T22:00:00+00:00"
  }
}

GET /v1/options/quotes

Get a quote for a specific option contract.

Parameters

Parameter Type Required Description
symbol string Required Stock ticker symbol
strike number Required Strike price
expiration string Required Expiration date (YYYY-MM-DD format)
side string Optional Option side: "call" or "put" (default: call)

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
     "https://api.mycoveredcall.com/v1/options/quotes?symbol=AAPL&strike=150&expiration=2025-01-17&side=call"

Example Response

{
  "success": true,
  "data": {
    "symbol": "AAPL",
    "option_symbol": "AAPL250117C00150000",
    "strike": 150,
    "expiration": "2025-01-17",
    "side": "call",
    "bid": 5.20,
    "ask": 5.40,
    "mid": 5.30,
    "last": 5.25,
    "volume": 1250,
    "open_interest": 5000,
    "implied_volatility": 0.25,
    "delta": 0.52,
    "gamma": 0.03,
    "theta": -0.05,
    "vega": 0.15,
    "rho": 0.08,
    "updated": 1699564800
  },
  "timestamp": "2025-11-11T22:00:00+00:00"
}

Error Responses

The API uses standard HTTP status codes and returns errors in JSON format:

401 Unauthorized

{
  "success": false,
  "error": "Invalid API key",
  "message": "The provided API key is invalid, inactive, or expired",
  "timestamp": "2025-11-11T22:00:00+00:00"
}

429 Too Many Requests

{
  "success": false,
  "error": "Rate limit exceeded",
  "message": "Rate limit of 100 requests per minute exceeded. Resets at 2025-11-11 22:01:00",
  "timestamp": "2025-11-11T22:00:00+00:00"
}

404 Not Found

{
  "success": false,
  "error": "Symbol not found",
  "message": "Could not fetch quote for symbol: INVALID",
  "timestamp": "2025-11-11T22:00:00+00:00"
}

Contact & Support

Need an API key? Contact the administrator to request access.

Questions or Issues? Please reach out via the support channel.