API Documentation

The RockHewn AI Sentiment API provides real-time access to sentiment-analyzed financial data from press releases, news articles, and SEC 8-K reports.

Quick Start

1. Sign up for a free account
2. Create an API key in your dashboard
3. Make your first API call (see examples below)

All API requests require authentication using an API key. Include your key in the Authorization header:

Authorization: Bearer rh_your_api_key_here

Retrieve sentiment-analyzed financial data with flexible filtering options.

Query Parameters

Response Format

{
  "data": [
    {
      "article_id": "abc123",
      "ticker": "AAPL",
      "sentiment": "Positive",
      "sentiment_score": 7.5,
      "scored_at": "2026-06-15T09:00:00Z",
      "json_data": { ... },
      "source": "pr"
    }
  ],
  "meta": {
    "count": 10,
    "has_more": true,
    "response_time_ms": 350,
    "plan": "free",
    "rate_limit_remaining": "45"
  }
}

Rate limits are applied per API key and vary by plan:

Rate limit information is included in every API response under meta.rate_limit_remaining.

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

{
  "error": "Rate limit exceeded",
  "message": "You have exceeded your API rate limit..."
}

cURL

# Get latest 10 items
curl "https://www.rockhewn.com/api/v1/sentiment?limit=10" \
  -H "Authorization: Bearer rh_your_api_key"

# Filter by ticker
curl "https://www.rockhewn.com/api/v1/sentiment?ticker=AAPL&limit=5" \
  -H "Authorization: Bearer rh_your_api_key"

# High sentiment scores only
curl "https://www.rockhewn.com/api/v1/sentiment?score_min=7&limit=10" \
  -H "Authorization: Bearer rh_your_api_key"

Python

import requests

API_KEY = "rh_your_api_key"
BASE_URL = "https://www.rockhewn.com/api/v1"

headers = {"Authorization": f"Bearer {API_KEY}"}

response = requests.get(
    f"{BASE_URL}/sentiment",
    headers=headers,
    params={"ticker": "AAPL", "limit": 10, "score_min": 7}
)

data = response.json()
for item in data['data']:
    print(f"{item['ticker']}: {item['sentiment']}")

JavaScript (Node.js)

const API_KEY = "rh_your_api_key";
const BASE_URL = "https://rockhewn.com/api/v1";

async function getSentiment(ticker, limit = 10) {
  const response = await fetch(
    `${BASE_URL}/sentiment?ticker=${ticker}&limit=${limit}`,
    { headers: { "Authorization": `Bearer ${API_KEY}` } }
  );
  return await response.json();
}

getSentiment("AAPL", 5).then(data => {
  console.log(`Found ${data.meta.count} results`);
});