Acuity Lab API Documentation - Financial Data Repository

Base URL: https://acuitylab.net/api/financial

Authentication

All requests to the Financial Data API require an API key. Include the API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Error Responses

200 OK: Request was successful.
400 Bad Request: The request was invalid.
401 Unauthorized: API key is missing or invalid.
403 Forbidden: The API key does not have permissions for the requested resource.
404 Not Found: The requested resource could not be found.
500 Internal Server Error: Something went wrong on the server side.

6.1 GET /financial/market-data

Retrieve live market data for stocks, ETFs, and indices.

GET https://acuitylab.net/api/financial/market-data?symbol=AAPL&interval=1day

{
    "symbol": "AAPL",
    "exchange": "NASDAQ",
    "market_data": {
        "open": 150.00,
        "high": 155.00,
        "low": 149.00,
        "close": 152.50,
        "volume": 5000000,
        "timestamp": "2024-02-25"
    }
}

6.2 GET /financial/historical-data

Retrieve historical market data for a stock or asset, including open, high, low, close prices (OHLC), and volume.

GET https://acuitylab.net/api/financial/historical-data?symbol=GOOGL&date_range=2023-01-01to2024-01-01

{
    "symbol": "GOOGL",
    "historical_data": [
        {
            "date": "2023-02-01",
            "open": 2900.00,
            "high": 2950.00,
            "low": 2850.00,
            "close": 2925.00,
            "volume": 3000000
        },
        {
            "date": "2023-02-02",
            "open": 2925.00,
            "high": 2975.00,
            "low": 2900.00,
            "close": 2950.00,
            "volume": 3500000
        }
    ]
}

6.3 GET /financial/dividends

Retrieve dividend data for a stock, including the dividend yield and payment history.

GET https://acuitylab.net/api/financial/dividends?symbol=MSFT

{
    "symbol": "MSFT",
    "dividends": [
        {
            "ex_dividend_date": "2024-01-10",
            "payment_date": "2024-02-01",
            "amount": 0.62,
            "yield": "1.1%"
        },
        {
            "ex_dividend_date": "2023-10-10",
            "payment_date": "2023-11-01",
            "amount": 0.60,
            "yield": "1.0%"
        }
    ]
}

6.4 GET /financial/earnings

Retrieve earnings data, including earnings per share (EPS) and revenue, for a specified stock.

GET https://acuitylab.net/api/financial/earnings?symbol=AMZN

{
    "symbol": "AMZN",
    "earnings": [
        {
            "report_date": "2024-01-31",
            "eps": 15.30,
            "revenue": 135000000,
            "estimate": 14.50,
            "surprise": 0.80
        },
        {
            "report_date": "2023-10-31",
            "eps": 12.10,
            "revenue": 120000000,
            "estimate": 11.80,
            "surprise": 0.30
        }
    ]
}

6.5 GET /financial/financials

Retrieve comprehensive financial statements (balance sheet, income statement, and cash flow) for a stock.

GET https://acuitylab.net/api/financial/financials?symbol=GOOGL&statement_type=income_statement

{
    "symbol": "GOOGL",
    "financials": {
        "income_statement": [
            {
                "date": "2024-01-31",
                "revenue": 135000000,
                "net_income": 25000000,
                "operating_expense": 100000000
            },
            {
                "date": "2023-10-31",
                "revenue": 130000000,
                "net_income": 24000000,
                "operating_expense": 102000000
            }
        ]
    }
}

6.6 GET /financial/splits

Retrieve data on stock splits for a specified symbol, including split ratio and dates.

GET https://acuitylab.net/api/financial/splits?symbol=TSLA

{
    "symbol": "TSLA",
    "splits": [
        {
            "split_date": "2022-08-24",
            "ratio": "3:1"
        },
        {
            "split_date": "2020-08-31",
            "ratio": "5:1"
        }
    ]
}

6.7 GET /financial/insider-transactions

Retrieve insider trading data, including the buying and selling of company shares by executives and major shareholders.

GET https://acuitylab.net/api/financial/insider-transactions?symbol=AAPL&date_range=2024-01-01to2024-03-01

{
    "symbol": "AAPL",
    "insider_transactions": [
        {
            "transaction_date": "2024-02-01",
            "executive_name": "John Doe",
            "position": "CEO",
            "transaction_type": "Buy",
            "shares": 5000,
            "price_per_share": 150.00
        },
        {
            "transaction_date": "2024-01-15",
            "executive_name": "Jane Smith",
            "position": "CFO",
            "transaction_type": "Sell",
            "shares": 3000,
            "price_per_share": 152.50
        }
    ]
}

6.8 GET /financial/analyst-ratings

Retrieve analyst ratings and price targets for a stock, including buy/sell recommendations.

GET https://acuitylab.net/api/financial/analyst-ratings?symbol=NFLX

{
    "symbol": "NFLX",
    "ratings": [
        {
            "date": "2024-02-15",
            "analyst_name": "Morgan Stanley",
            "rating": "Buy",
            "price_target": 450.00
        },
        {
            "date": "2024-01-10",
            "analyst_name": "JP Morgan",
            "rating": "Hold",
            "price_target": 400.00
        }
    ]
}