# Valuation Comparison

`GET` `/v1/quote/compare/valuation`

Compare valuation metrics (PE/PB/PS/market cap/close price) across multiple stocks. When no comparison symbols are provided, the server automatically selects peers from the same industry.

## Parameters

### Query Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | Yes | Primary security symbol, e.g. `AAPL.US` |
| `currency` | string | Yes | Result currency: `USD`, `HKD`, or `CNY` |
| `comparison_symbols` | array | No | Symbols to compare against; if omitted, the server auto-selects industry peers |

## Request Example

```bash
curl --request GET \
  --url 'https://openapi.longbridge.com/v1/quote/compare/valuation?symbol=<symbol>&currency=<currency>' \
  --header 'Authorization: Bearer <access_token>'
```

## Response

### Response Properties

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `list` | object[] | No | Valuation comparison list |
| `└ symbol` | string | No | Security symbol |
| `└ name` | string | No | Security name |
| `└ market` | string | No | Market: `US`, `HK`, `CN`, `SG` |
| `└ currency` | string | No | Currency of the values |
| `└ price_close` | string | No | Latest closing price |
| `└ market_value` | string | No | Market capitalisation |
| `└ volume` | string | No | Volume. |
| `└ pe` | string | No | P/E ratio (TTM) |
| `└ pb` | string | No | P/B ratio |
| `└ ps` | string | No | P/S ratio (TTM) |
| `└ div_yld` | string | No | Dividend yield (%) |
| `└ roa` | string | No | Return on assets (ROA). |
| `└ roe` | string | No | Return on equity (%) |
| `└ turnover` | string | No | Turnover. |
| `└ net_margin` | string | No | Net profit margin |
| `└ leverage` | string | No | Leverage ratio. |
| `└ liabilities_assets` | string | No | Liabilities-to-assets ratio. |
| `└ eps` | string | No | Earnings per share (TTM) |
| `└ sales_ps` | string | No | Sales per share. |
| `└ bps` | string | No | Book value per share |
| `└ dps` | string | No | Dividends per share (TTM) |
| `└ five_y_avg_dps` | string | No | 5-year average DPS |
| `└ div_payout_ratio` | string | No | Dividend payout ratio |
| `└ assets` | string | No | Total assets |
| `└ liabilities` | string | No | Total liabilities. |
| `└ sales` | string | No | Sales / revenue. |
| `└ net_income` | string | No | Net income |
| `└ history` | object[] | No | Historical valuation time series |
| `└ ∟ date` | string | No | Date as Unix timestamp (seconds) |
| `└ ∟ pe` | string | No | P/E ratio (TTM) |
| `└ ∟ pb` | string | No | P/B ratio |
| `└ ∟ ps` | string | No | P/S ratio (TTM) |

### Response JSON Example

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "list": [
      {
        "symbol": "AAPL.US",
        "name": "Apple Inc.",
        "currency": "USD",
        "market_value": "3241500000000",
        "price_close": "213.49",
        "pe": "32.15",
        "pb": "50.21",
        "ps": "8.04",
        "roe": "136.45",
        "eps": "6.43",
        "bps": "4.38",
        "dps": "0.99",
        "div_yld": "0.46",
        "assets": "371082000000",
        "history": [
          {
            "date": "1622520000",
            "pe": "37.56",
            "pb": "30.16",
            "ps": "6.41"
          },
          {
            "date": "1625112000",
            "pe": "41.49",
            "pb": "35.64",
            "ps": "6.60"
          }
        ]
      },
      {
        "symbol": "MSFT.US",
        "name": "Microsoft",
        "currency": "USD",
        "market_value": "3085000000000",
        "price_close": "415.32",
        "pe": "35.42",
        "pb": "12.87",
        "ps": "12.61",
        "roe": "38.21",
        "eps": "11.72",
        "bps": "32.28",
        "dps": "3.32",
        "div_yld": "0.80",
        "assets": "512163000000",
        "history": [
          {
            "date": "1622520000",
            "pe": "33.12",
            "pb": "11.94",
            "ps": "11.84"
          }
        ]
      }
    ]
  }
}
```
