Get Single Company Details

curl --request GET \
  --url https://data-tools.prd.arrays.org/api/v1/stocks/company/detail \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://data-tools.prd.arrays.org/api/v1/stocks/company/detail', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://data-tools.prd.arrays.org/api/v1/stocks/company/detail",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://data-tools.prd.arrays.org/api/v1/stocks/company/detail"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://data-tools.prd.arrays.org/api/v1/stocks/company/detail")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "ceo": "Jensen Huang",
      "cik": "0001045810",
      "company_description": "NVIDIA Corporation provides graphics and compute solutions.",
      "country": "United States",
      "employees": 29600,
      "exchange": "NASDAQ",
      "exchange_short_name": "NASDAQ",
      "industry": "Semiconductors",
      "ipo_date": "1999-01-22",
      "is_adr": false,
      "is_etf": false,
      "is_fund": false,
      "is_listed": true,
      "logo": "https://example.com/logo.png",
      "name": "NVIDIA Corporation",
      "sector": "Technology",
      "symbol": "NVDA",
      "website": "https://www.nvidia.com"
    }
  ],
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "details": [
      {
        "field": "<string>",
        "got": "<string>",
        "reason": "<string>"
      }
    ],
    "docs_url": "<string>",
    "examples": [
      "<string>"
    ],
    "hint": "<string>",
    "message": "The requested resource was not found.",
    "suggestions": [
      "<string>"
    ]
  },
  "metadata": "<unknown>",
  "pagination": "<unknown>",
  "request_id": "<string>",
  "success": true
}

{
  "data": "<unknown>",
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "details": [
      {
        "field": "<string>",
        "got": "<string>",
        "reason": "<string>"
      }
    ],
    "docs_url": "<string>",
    "examples": [
      "<string>"
    ],
    "hint": "<string>",
    "message": "The requested resource was not found.",
    "suggestions": [
      "<string>"
    ]
  },
  "metadata": "<unknown>",
  "pagination": "<unknown>",
  "request_id": "<string>",
  "success": true
}

{
  "data": "<unknown>",
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "details": [
      {
        "field": "<string>",
        "got": "<string>",
        "reason": "<string>"
      }
    ],
    "docs_url": "<string>",
    "examples": [
      "<string>"
    ],
    "hint": "<string>",
    "message": "The requested resource was not found.",
    "suggestions": [
      "<string>"
    ]
  },
  "metadata": "<unknown>",
  "pagination": "<unknown>",
  "request_id": "<string>",
  "success": true
}

Stock

Get Single Company Details

Feature Overview OpenAPI JSON Spec Retrieve the profile of a single company based on stock symbol or company name keyword — identity, classification, and descriptive attributes. Suitable for company detail pages, company search, and more. Valuation and financial metrics are served by the dedicated /stocks/market-metrics and /stocks/financial-metrics endpoints. Main Use Cases

Company Detail Pages: Display the profile of a single company
Company Search: Resolve a stock symbol or name keyword to a company profile
Mobile Applications: Provide data interface for company detail pages
Desktop Software: Provide company data for professional investment software

Query Parameter Description

Supports two query methods:

Exact Query: Find company precisely by stock symbol
Fuzzy Query: Fuzzy match by company name keyword

Response Data Description

The returned company profile includes:

Basic Info: Stock symbol, company name, industry classification, exchange
Profile: Description, website, CEO, employees, country, IPO date, listing flags (is_etf/is_adr/is_fund)

Valuation and financial metrics are not returned here — use /stocks/market-metrics (PE/PS/market cap) and /stocks/financial-metrics (revenue/EPS/ROE TTM).

Usage Examples

Query Apple company by stock symbol: ?symbol=AAPL
Query by company name keyword: ?name_kw=Apple
Use both stock symbol and name keyword: ?symbol=AAPL&name_kw=Apple

Best Practices

Prioritize using stock symbol for exact queries, faster response
Name keyword query supports fuzzy matching, suitable for search functionality
Recommend caching query results for popular companies
For mobile applications, preload data for commonly used companies

Important Notes

Symbol parameter must be uppercase, e.g., AAPL, GOOGL
name_kw parameter supports Chinese and English, case-insensitive
If both symbol and name_kw are provided, symbol takes priority

GET

stocks

company

detail

Get Single Company Details

curl --request GET \
  --url https://data-tools.prd.arrays.org/api/v1/stocks/company/detail \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://data-tools.prd.arrays.org/api/v1/stocks/company/detail', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://data-tools.prd.arrays.org/api/v1/stocks/company/detail",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://data-tools.prd.arrays.org/api/v1/stocks/company/detail"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://data-tools.prd.arrays.org/api/v1/stocks/company/detail")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "ceo": "Jensen Huang",
      "cik": "0001045810",
      "company_description": "NVIDIA Corporation provides graphics and compute solutions.",
      "country": "United States",
      "employees": 29600,
      "exchange": "NASDAQ",
      "exchange_short_name": "NASDAQ",
      "industry": "Semiconductors",
      "ipo_date": "1999-01-22",
      "is_adr": false,
      "is_etf": false,
      "is_fund": false,
      "is_listed": true,
      "logo": "https://example.com/logo.png",
      "name": "NVIDIA Corporation",
      "sector": "Technology",
      "symbol": "NVDA",
      "website": "https://www.nvidia.com"
    }
  ],
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "details": [
      {
        "field": "<string>",
        "got": "<string>",
        "reason": "<string>"
      }
    ],
    "docs_url": "<string>",
    "examples": [
      "<string>"
    ],
    "hint": "<string>",
    "message": "The requested resource was not found.",
    "suggestions": [
      "<string>"
    ]
  },
  "metadata": "<unknown>",
  "pagination": "<unknown>",
  "request_id": "<string>",
  "success": true
}

{
  "data": "<unknown>",
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "details": [
      {
        "field": "<string>",
        "got": "<string>",
        "reason": "<string>"
      }
    ],
    "docs_url": "<string>",
    "examples": [
      "<string>"
    ],
    "hint": "<string>",
    "message": "The requested resource was not found.",
    "suggestions": [
      "<string>"
    ]
  },
  "metadata": "<unknown>",
  "pagination": "<unknown>",
  "request_id": "<string>",
  "success": true
}

{
  "data": "<unknown>",
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "details": [
      {
        "field": "<string>",
        "got": "<string>",
        "reason": "<string>"
      }
    ],
    "docs_url": "<string>",
    "examples": [
      "<string>"
    ],
    "hint": "<string>",
    "message": "The requested resource was not found.",
    "suggestions": [
      "<string>"
    ]
  },
  "metadata": "<unknown>",
  "pagination": "<unknown>",
  "request_id": "<string>",
  "success": true
}

Authorizations

X-API-Key

string

header

required

API Key authentication. Example: "your-api-key-here"

Query Parameters

symbol

string

Stock symbol (uppercase, e.g., AAPL)

name

string

Company name keyword (English, case-insensitive)

Response

Successfully retrieved company details

data

object[]

Show child attributes

error

object

Show child attributes

metadata

any

pagination

any

request_id

string

success

boolean