​
Company Information API

Get detailed company information including corporate profiles, insider trading activities, and shareholder data.

​
Available Endpoints

​
Company Profile

Get basic company information including business description, sector, industry, and key metrics. 
GET /api/company/{symbol}/profile
Example Request: 
curl -X GET "https://api.financialcontext.com/api/company/AAPL/profile" \
  -H "X-API-Key: your-api-key"
Response: 
{
  "success": true,
  "data": {
    "symbol": "AAPL",
    "companyName": "Apple Inc.",
    "sector": "Technology",
    "industry": "Consumer Electronics",
    "description": "Apple Inc. designs, manufactures, and markets smartphones...",
    "website": "https://www.apple.com",
    "employees": 164000,
    "marketCap": 3000000000000
  }
}

​
Insider Trades

Track insider trading activities by company executives and major shareholders. 
GET /api/company/{symbol}/insider-trades
Example Request: 
curl -X GET "https://api.financialcontext.com/api/company/AAPL/insider-trades" \
  -H "X-API-Key: your-api-key"
Response: 
{
  "success": true,
  "data": {
    "trades": [
      {
        "date": "2024-01-15",
        "insider": "Tim Cook",
        "position": "CEO",
        "transactionType": "Sale",
        "shares": 50000,
        "pricePerShare": 185.50,
        "totalValue": 9275000
      }
    ]
  }
}

​
Company Shareholders

Get information about major shareholders and institutional ownership. 
GET /api/company/{symbol}/shareholders
Example Request: 
curl -X GET "https://api.financialcontext.com/api/company/AAPL/shareholders" \
  -H "X-API-Key: your-api-key"

​
Use Cases

Due Diligence

Research companies before making investment decisions

Insider Activity Monitoring

Track insider trading patterns for market insights

Ownership Analysis

Analyze institutional ownership and major shareholders

Company Screening

Filter companies based on fundamental criteria

​
Parameters

ParameterTypeRequiredDescription
symbolstringYesStock ticker symbol (e.g., AAPL, MSFT)

​
Response Format

All company endpoints return data in a consistent format:
  • success: Boolean indicating if the request was successful
  • data: Object containing the requested company information
  • message: Descriptive message about the response
  • timestamp: ISO 8601 timestamp of the response

​
Error Handling

Common error responses:
  • 400 Bad Request: Invalid symbol format
  • 404 Not Found: Company data not available
  • 429 Too Many Requests: Rate limit exceeded
  • 500 Internal Server Error: Server error
Company data is updated daily. Some information may have a 1-day delay.