Company

Company profiles, search, corporate events, social sentiment, financial news, SEC filings, sector classification, and AI-generated descriptions.

Base URLhttps://api.apps.myallies.com/v1
GET/company/{code}Get company profileexpand_less

Get company profile

API Key (X-Api-Key)

Retrieve detailed company information including name, ISIN, market cap, summary, and logo URL for the specified contract.

Parameters

NameTypeDescription
code *
path
string
Contract code in SYMBOL_EXCHANGE format. Use GET /market/exchanges/{symbol} to find available exchanges.

Responses

200Company profile data
404Symbol not found
curl -X GET "https://api.apps.myallies.com/v1/company/AAPL_NASDAQ" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response Example
{
  "success": true,
  "data": {
    "symbol": "AAPL",
    "name": "Apple Inc.",
    "isin": "US0378331005",
    "marketCap": 2780000000000,
    "summary": "Apple Inc. designs, manufactures, and markets smartphones, personal computers, tablets, wearables, and accessories worldwide.",
    "logoUrl": "https://logo.clearbit.com/apple.com",
    "lastUpdated": "2026-03-17T08:00:00Z"
  },
  "error": null,
  "meta": {
    "requestId": "req_s1t2u3",
    "timestamp": "2026-03-17T10:06:00Z",
    "version": "v1"
  }
}

terminal Try It

expand_more
GET/company/searchSearch companiesexpand_less

Search companies

API Key (X-Api-Key)

Search for companies by name or ticker symbol. Returns matching symbols with exchange and contract type information.

Parameters

NameTypeDescription
q *
query
string
Search query (e.g., "apple" or "AAPL")

Responses

200Search results
400Search query is required
curl -X GET "https://api.apps.myallies.com/v1/company/search?q=apple" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response Example
{
  "success": true,
  "data": {
    "results": [
      {
        "symbol": "AAPL",
        "name": "Apple Inc.",
        "exchange": "NASDAQ",
        "contractType": "STK"
      },
      {
        "symbol": "APLE",
        "name": "Apple Hospitality REIT",
        "exchange": "NYSE",
        "contractType": "STK"
      }
    ]
  },
  "error": null,
  "meta": {
    "requestId": "req_v4w5x6",
    "timestamp": "2026-03-17T10:07:00Z",
    "version": "v1"
  }
}

terminal Try It

expand_more
GET/company/{code}/eventsGet corporate eventsexpand_less

Get corporate events

API Key (X-Api-Key)

Retrieve upcoming corporate events for a company, including earnings announcements with EPS estimates, revenue estimates, and announcement timing.

Parameters

NameTypeDescription
code *
path
string
Contract code in SYMBOL_EXCHANGE format. Use GET /market/exchanges/{symbol} to find available exchanges.

Responses

200Upcoming corporate events
404No upcoming events found
curl -X GET "https://api.apps.myallies.com/v1/company/AAPL_NASDAQ/events" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response Example
{
  "success": true,
  "data": [
    {
      "eventType": "EarningsCalendar",
      "eventDate": "2026-04-24",
      "daysToEvent": 38,
      "earnings": {
        "quarter": 2,
        "year": 2026,
        "hour": "AMC",
        "epsEstimate": 1.62,
        "epsActual": null,
        "revenueEstimate": 94500000000,
        "revenueActual": null
      }
    }
  ],
  "error": null,
  "meta": {
    "requestId": "req_ev1t2",
    "timestamp": "2026-03-17T10:08:00Z",
    "version": "v1"
  }
}

terminal Try It

expand_more
GET/company/{code}/socialGet social sentimentexpand_less

Get social sentiment

API Key (X-Api-Key)

Retrieve social media sentiment data from StockTwits for a stock. Returns recent messages with individual sentiment tags, aggregated bullish/bearish counts, and an overall sentiment ratio.

Parameters

NameTypeDescription
code *
path
string
Contract code in SYMBOL_EXCHANGE format. Use GET /market/exchanges/{symbol} to find available exchanges.

Responses

200Social sentiment data
404No social data found for symbol
curl -X GET "https://api.apps.myallies.com/v1/company/AAPL_NASDAQ/social" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response Example
{
  "success": true,
  "data": {
    "symbol": "AAPL",
    "title": "Apple Inc.",
    "watchlistCount": 425680,
    "messageCount": 20,
    "bullishCount": 14,
    "bearishCount": 4,
    "sentimentRatio": 0.778,
    "sentiment": "Bullish",
    "messages": [
      {
        "id": 581234,
        "body": "$AAPL looking strong above 178, breakout incoming",
        "createdAt": "2026-03-23T15:20:00Z",
        "username": "trader_mike",
        "sentiment": "Bullish",
        "likes": 12
      },
      {
        "id": 581230,
        "body": "$AAPL earnings will disappoint, selling calls",
        "createdAt": "2026-03-23T15:15:00Z",
        "username": "bear_capital",
        "sentiment": "Bearish",
        "likes": 3
      }
    ]
  },
  "error": null,
  "meta": {
    "requestId": "req_so1c2",
    "timestamp": "2026-03-23T15:30:01Z",
    "version": "v1"
  }
}

terminal Try It

expand_more
GET/company/{code}/filingsGet SEC filingsexpand_less

Get SEC filings

API Key (X-Api-Key)

Returns recent SEC filings for a company including Form 4 insider trades, 10-K annual reports, 10-Q quarterly reports, and other regulatory filings.

Parameters

NameTypeDescription
code *
path
string
Contract code (SYMBOL_EXCHANGE, e.g. AAPL_NASDAQ)

Responses

200SEC filings list
404No filings found
curl -X GET "https://api.apps.myallies.com/v1/company/code/filings" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response Example
{
  "success": true,
  "data": [
    {
      "form": "4",
      "filingDate": "2026-03-18",
      "accessionNumber": "0001234567-26-000123",
      "reportDate": "2026-03-16"
    },
    {
      "form": "10-K",
      "filingDate": "2026-02-01",
      "accessionNumber": "0001234567-26-000042",
      "reportDate": "2025-12-31"
    }
  ],
  "error": null,
  "meta": {
    "requestId": "req_sf01",
    "timestamp": "2026-03-23T12:00:00Z",
    "version": "v1"
  }
}

terminal Try It

expand_more
GET/company/{code}/sectorGet sector and industry dataexpand_less

Get sector and industry data

API Key (X-Api-Key)

Returns the sector and industry classification for a company along with its name and market capitalization.

Parameters

NameTypeDescription
code *
path
string
Contract code (SYMBOL_EXCHANGE, e.g. AAPL_NASDAQ)

Responses

200Company sector data
404Company not found
curl -X GET "https://api.apps.myallies.com/v1/company/code/sector" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response Example
{
  "success": true,
  "data": {
    "symbol": "AAPL",
    "name": "Apple Inc.",
    "marketCap": 3420000000000
  },
  "error": null,
  "meta": {
    "requestId": "req_sc01",
    "timestamp": "2026-03-23T12:00:00Z",
    "version": "v1"
  }
}

terminal Try It

expand_more
GET/company/{code}/descriptionGet company descriptionexpand_less

Get company description

API Key (X-Api-Key)

Retrieve a company description sourced from 10-K filings or AI-generated. Includes the source type, exchange, industry, and last update timestamp.

Parameters

NameTypeDescription
code *
path
string
Contract code (e.g., AAPL_NASDAQ)

Responses

200Company description
curl -X GET "https://api.apps.myallies.com/v1/company/AAPL_NASDAQ/description" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response Example
{
  "success": true,
  "data": {
    "symbol": "AAPL",
    "name": "Apple Inc.",
    "description": "Apple Inc. designs, manufactures, and markets smartphones, personal computers, tablets, wearables, and accessories worldwide...",
    "source": "10-K",
    "exchange": "NASDAQ",
    "industry": "Consumer Electronics",
    "updatedOn": "2026-03-15T00:00:00Z"
  },
  "error": null,
  "meta": {
    "requestId": "req_cd1w3",
    "timestamp": "2026-04-13T10:00:00Z",
    "version": "v1"
  }
}

terminal Try It

expand_more
cookie

हम आपके अनुभव को बेहतर बनाने के लिए कुकीज़ और एनालिटिक्स का उपयोग करते हैं हमारी देखेंगोपनीयता नीति