Skip to main content
GET
/
instruments
/
{symbol}
/
history
Get compliance history
curl --request GET \
  --url https://api.halal.sh/v1/instruments/{symbol}/history \
  --header 'X-API-Key: <api-key>'
{
  "data": {
    "symbol": "<string>",
    "history": [
      {
        "period": "Q4 2025",
        "date": "2023-12-25",
        "status": "compliant",
        "confidence": 123,
        "key_ratios": {
          "debt_to_market_cap": 123,
          "prohibited_revenue": 123,
          "cash_to_market_cap": 123
        }
      }
    ],
    "stability": {
      "quarters_compliant": 8,
      "quarters_total": 8,
      "flip_rate": 0,
      "closest_threshold": {
        "screen": "cash_to_market_cap",
        "current_distance": 0.105,
        "median_distance": 123,
        "trend": "stable"
      },
      "stability_rating": "stable",
      "stability_drivers": [
        {
          "code": "<string>",
          "message": "<string>",
          "severity": "info"
        }
      ]
    }
  },
  "meta": {
    "request_id": "req_abc123",
    "methodology": "aaoifi-ss21@2024",
    "as_of": "2026-03-08T12:00:00Z",
    "retry_after": 120
  }
}

Authorizations

X-API-Key
string
header
required

Path Parameters

symbol
string
required

Stock ticker symbol (e.g., AAPL, NVDA, MSFT).

Required string length: 1 - 10
Example:

"NVDA"

Query Parameters

period
enum<string>
default:1y

Time period for history data.

Available options:
1m,
3m,
6m,
1y,
2y,
5y

Response

History data

data
object
meta
object