# 🇻🇳 HOSE Vietnam Stock Screener — VN30 Quotes & Fundamentals (`nexgendata/hose-vietnam-stock-screener`) Actor

HOSE Vietnam stock screener API — VN30 / VN-Index live quotes, market cap (VND), P/E, P/B, dividend yield, ROE, sector. Vietcombank, Vingroup, Hoa Phat, FPT universe. Bloomberg Terminal / FactSet / Refinitiv Eikon alternative for Vietnam frontier-market data. Pay-per-result pricing.

- **URL**: https://apify.com/nexgendata/hose-vietnam-stock-screener.md
- **Developed by:** [Stephan Corbeil](https://apify.com/nexgendata) (community)
- **Categories:** Business, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $250.00 / 1,000 hose stock records

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## HOSE Vietnam Stock Screener — VN30 Quotes & Fundamentals

Track the **Ho Chi Minh Stock Exchange (HOSE / HSX)** — Vietnam's main equity market — with one Apify run. This actor scrapes every HOSE-listed common stock (roughly 400 tickers including VN30 blue chips) and returns institutional-grade price, market cap, fundamental, and sector data in a single dataset. Built for hedge fund analysts, frontier-market quants, ETF research desks, and Vietnam-focused PE shops that need clean, schema-consistent feeds without paying Bloomberg/Refinitiv terminal rates.

Vietnam is the fastest-growing major frontier-market equity story in Asia: 6%+ real GDP growth, a young population, MSCI Emerging Markets reclassification candidate, and a domestic investor base that has tripled since 2020. The HOSE is the dominant exchange (vs the smaller HNX in Hanoi) and the VN30 is the bellwether index tracked by every VN30 futures contract, VN-Index ETF, and Vietnam country fund worldwide.

### What this actor returns

For every HOSE ticker (subject to your filters), the actor emits one JSON record with these fields:

- **`symbol`** — HOSE 3-letter ticker (VIC, VHM, VCB, HPG, VNM, ...)
- **`name`** — Full company name as listed (English where available)
- **`is_vn30`** — `true` if the ticker is in the VN30 blue-chip index
- **`market`** — Always `"HOSE"`
- **`country`** — `"Vietnam"`
- **`currency`** — `"VND"` (Vietnamese Dong)
- **`price_vnd`** — Latest stock price in Vietnamese Dong
- **`pct_change`** — Most recent percent change
- **`market_cap_billion_vnd`** — Market capitalization in BILLION VND (1B VND ≈ $40,000 USD)
- **`market_cap_usd_million`** — Auto-computed USD equivalent (1 USD ≈ 25,000 VND)
- **`revenue_ttm_billion_vnd`** — Trailing-twelve-month revenue in billion VND
- **`pe_ratio`** — Trailing price-to-earnings ratio
- **`forward_pe`** — Forward price-to-earnings ratio
- **`eps_vnd`** — Trailing earnings per share, VND
- **`dividend_yield_pct`** — Trailing dividend yield, percent
- **`dividend`** — Dividend per share value (or null)
- **`ex_dividend_date`** — Most recent ex-dividend date
- **`beta`** — 5-year beta vs Vietnam market
- **`rsi`** — 14-day RSI (technical momentum)
- **`shares_outstanding`** — Share count
- **`volume`** — Latest session volume
- **`average_volume`** — Average daily volume
- **`open_vnd`** / **`previous_close_vnd`** — Price levels
- **`day_low_vnd`** / **`day_high_vnd`** — Intraday range
- **`week52_low_vnd`** / **`week52_high_vnd`** — 52-week range
- **`sector`** / **`industry`** — Sector & industry classification
- **`employees`** / **`founded`** — Company profile
- **`earnings_date`** — Next earnings release
- **`stockanalysis_url`** — Backreference URL for verification
- **`scraped_at`** — ISO-8601 UTC scrape timestamp

### Input parameters

| Field | Type | Default | Description |
| --- | --- | --- | --- |
| `limit` | int | 50 | Cap on records returned (1-500). |
| `market` | enum | `HOSE-all` | `HOSE-all` (~400 tickers) or `VN30` (blue-chip index, 30 tickers). |
| `min_market_cap_vnd_billion` | int | 0 | Filter min market cap, billion VND (e.g. 10000 = 10T VND ≈ $400M USD). |
| `sector` | string | `""` | Case-insensitive keyword (e.g. `bank`, `real estate`, `food`). |
| `include_fundamentals` | bool | true | Enrich each ticker with per-page P/E, EPS, beta, sector, 52-week range. |
| `proxyConfiguration` | object | Apify | Apify proxy config; defaults to datacenter. |

### Example use cases

- **VN30 daily snapshot** — `{"market": "VN30", "limit": 30}` pulls the entire blue-chip index with full fundamentals in one go. Drop the result into your portfolio dashboard.
- **Vietnam bank screen** — `{"sector": "bank", "limit": 25, "min_market_cap_vnd_billion": 10000}` returns large-cap Vietnamese banks (VCB, BID, CTG, TCB, MBB, ACB, VPB, HDB, STB, SHB, TPB, VIB, OCB, EIB, MSB, LPB...) with capital ratios reflected in price/book.
- **Vingroup empire** — `{"sector": "vin"}` pulls VIC (parent), VHM (Vinhomes residential REIT), and VRE (Vincom Retail) together with current valuations.
- **Frontier-market value screen** — Filter `min_market_cap_vnd_billion: 1000` with downstream filtering by `pe_ratio < 12` to find Vietnamese deep-value candidates.
- **Mid-cap discovery** — `{"limit": 200, "include_fundamentals": false}` pulls the entire HOSE universe minus per-page enrichment in seconds for daily price-only refreshes.

### Pricing

Pay-per-event: **$0.25 per HOSE stock record** plus $0.01 once per run for startup. A full VN30 pull costs ~$7.51 ($0.01 start + 30 × $0.25), a complete HOSE universe pull costs ~$100.01. No platform usage or proxy fees on top — pricing is fully transparent and bundled.

Compared to Bloomberg ($24,000/yr/seat), Refinitiv Eikon ($22,000/yr), or FactSet ($12,000+/yr), this actor delivers the same Vietnamese equity dataset on demand at a fraction of the cost — pay only for what you actually scrape, when you scrape it.

### Data source & methodology

The primary source is **stockanalysis.com/list/ho-chi-minh-stock-exchange/** — a server-rendered HTML list page covering every HOSE common stock with market cap, price, % change, and revenue. Each ticker's individual quote page (`stockanalysis.com/quote/hose/{SYMBOL}/`) is then fetched in parallel for fundamentals enrichment when `include_fundamentals=true`.

VN30 membership is flagged from the official HOSE indices roster. Market cap is normalized from the site's trillion-VND notation (e.g. `1,694.72T`) to billion-VND units for analyst convenience.

Vietnamese market hours: 09:00-11:30 (morning session) and 13:00-14:45 (afternoon session) ICT (UTC+7), Monday-Friday. Prices reflect the latest available session close; intraday values are end-of-session for that calendar day.

### Compliance & legal

This actor scrapes a publicly accessible third-party site (stockanalysis.com) that aggregates HOSE official market data. No login, no paywall, no terms-of-service violation. The data is informational and is NOT investment advice. Vietnamese equity markets are subject to foreign-ownership limits (FOLs) varying by sector — please consult a licensed Vietnamese broker before trading.

### Sister Apify actors — full Asian equity coverage

Build a complete Asia-Pacific equity research stack with the NexGenData fleet:

- **[Eastmoney China Stock Screener](https://apify.com/nexgendata/eastmoney-china-stock-screener?fpr=2ayu9b)** — Shanghai + Shenzhen A-shares (~5,000 tickers), CSI 300, Hang Seng China index, RMB-denominated fundamentals.
- **[KOSPI Stock Screener](https://apify.com/nexgendata/kospi-stock-screener?fpr=2ayu9b)** — Korean Stock Exchange (KOSPI) listings including Samsung, SK Hynix, Hyundai, LG, KOSPI 200 index, KRW-denominated.
- **[TWSE Stock Screener](https://apify.com/nexgendata/twse-stock-screener?fpr=2ayu9b)** — Taiwan Stock Exchange (~1,000 tickers) with TWD prices, P/E, dividend yield, sector (TSMC, Hon Hai/Foxconn, MediaTek...).
- **[HKEX Hang Seng Stock Screener](https://apify.com/nexgendata/hkex-hang-seng-stock-screener?fpr=2ayu9b)** — Hong Kong Exchange + Hang Seng Index + H-shares of mainland China giants in HKD.
- **[SGX Singapore Stock Screener](https://apify.com/nexgendata/sgx-singapore-stock-screener?fpr=2ayu9b)** — Singapore Exchange (SGX) blue chips, REITs, STI index constituents.

Run all six monthly and you have a complete pan-Asia equity feed for under $300/run — a fraction of one annual Bloomberg seat. Pair with our **Vietnam-specific macro and operational data feeds** (coming soon: GSO Vietnam GDP/CPI, SBV exchange rates, Hanoi/HCMC real-estate transactions) for a full alternative-data Vietnam stack.

### About NexGenData

NexGenData builds institutional-grade Apify actors covering frontier and emerging-market equity data, alternative datasets, and B2B scraping pipelines. Our fleet powers hedge funds, equity research desks, and corporate strategy teams that need clean, schema-consistent feeds without paying terminal prices. Every actor in the fleet follows the same JSON schema conventions so cross-market comparisons (Vietnam vs Thailand vs Indonesia, or China A-shares vs HKEX H-shares) are one SQL join away.

Vietnam is going to be the next great Asian growth story, and this actor is your fastest path to the underlying data.

**Browse the full NexGenData Apify fleet → https://apify.com/nexgendata?fpr=2ayu9b**

# Actor input Schema

## `limit` (type: `integer`):

Maximum number of HOSE-listed stocks to return. The Ho Chi Minh Stock Exchange has roughly 400 listed companies. Use 10 for a smoke test, 30 for the VN30 blue-chip index, or 400 to pull the entire HOSE universe. Records are returned sorted by market cap (in billion VND) descending so the most liquid Vietnamese blue-chips like VIC, VHM, VCB, HPG, VNM come first.
## `market` (type: `string`):

Which HOSE segment to scrape. 'HOSE-all' covers every Ho Chi Minh Stock Exchange common-stock listing (~400 tickers). 'VN30' restricts to the VN30 blue-chip index — the 30 largest, most liquid Vietnamese companies (VIC Vingroup, VHM Vinhomes, VCB Vietcombank, HPG Hoa Phat Group, VNM Vinamilk, BID BIDV, CTG VietinBank, TCB Techcombank, MSN Masan, MWG Mobile World, etc.). VN30 is the most-tracked benchmark for Vietnamese equities and the underlying for VN30 futures on HNX.
## `min_market_cap_vnd_billion` (type: `integer`):

Filter to stocks with market cap at or above this value, expressed in BILLION Vietnamese Dong (1 billion VND ≈ 40,000 USD at current rates). Examples: 1000 = 1 trillion VND (mid-cap), 10000 = 10 trillion VND (large-cap), 100000 = 100 trillion VND (VN30 mega-cap tier). Leave at 0 for no filter. VND market caps are quoted directly off the stockanalysis.com list view and converted from trillion-VND notation (e.g. '1,694.72T') to billion units.
## `sector` (type: `string`):

Optional case-insensitive substring filter applied to the company name and industry classification. Examples: 'bank' (Vietnamese banks like VCB, BID, CTG, TCB), 'real estate' (VIC, VHM, NVL, KDH), 'food' (VNM Vinamilk, MSN Masan), 'steel' (HPG Hoa Phat), 'retail' (MWG Mobile World, PNJ), 'oil' (PLX Petrolimex, GAS PetroVietnam Gas), 'utilities', 'logistics'. Leave blank to disable filtering.
## `include_fundamentals` (type: `boolean`):

If true, fetch each stock's individual quote page to enrich it with P/E ratio, P/B ratio (computed when book value available), EPS, beta, RSI, 52-week range, average volume, shares outstanding, sector/industry, dividend yield, ex-dividend date. This roughly doubles runtime since one extra HTTP request is needed per ticker. Recommended ON for institutional research; turn OFF for fast price-only scrapes of the full universe.
## `proxyConfiguration` (type: `object`):

Apify proxy configuration. stockanalysis.com tolerates datacenter proxies fine; switch to RESIDENTIAL only if you hit Cloudflare challenges when scraping the full 400-ticker universe with fundamentals enabled.

## Actor input object example

```json
{
  "limit": 50,
  "market": "HOSE-all",
  "min_market_cap_vnd_billion": 0,
  "include_fundamentals": true,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
````

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "limit": 50,
    "market": "HOSE-all",
    "min_market_cap_vnd_billion": 0,
    "sector": "",
    "include_fundamentals": true,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("nexgendata/hose-vietnam-stock-screener").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "limit": 50,
    "market": "HOSE-all",
    "min_market_cap_vnd_billion": 0,
    "sector": "",
    "include_fundamentals": True,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("nexgendata/hose-vietnam-stock-screener").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "limit": 50,
  "market": "HOSE-all",
  "min_market_cap_vnd_billion": 0,
  "sector": "",
  "include_fundamentals": true,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call nexgendata/hose-vietnam-stock-screener --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=nexgendata/hose-vietnam-stock-screener",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "🇻🇳 HOSE Vietnam Stock Screener — VN30 Quotes & Fundamentals",
        "description": "HOSE Vietnam stock screener API — VN30 / VN-Index live quotes, market cap (VND), P/E, P/B, dividend yield, ROE, sector. Vietcombank, Vingroup, Hoa Phat, FPT universe. Bloomberg Terminal / FactSet / Refinitiv Eikon alternative for Vietnam frontier-market data. Pay-per-result pricing.",
        "version": "0.0",
        "x-build-id": "dWm1v7jeTWiBjs4Qo"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/nexgendata~hose-vietnam-stock-screener/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-nexgendata-hose-vietnam-stock-screener",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/nexgendata~hose-vietnam-stock-screener/runs": {
            "post": {
                "operationId": "runs-sync-nexgendata-hose-vietnam-stock-screener",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/nexgendata~hose-vietnam-stock-screener/run-sync": {
            "post": {
                "operationId": "run-sync-nexgendata-hose-vietnam-stock-screener",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "limit": {
                        "title": "Limit",
                        "minimum": 1,
                        "maximum": 500,
                        "type": "integer",
                        "description": "Maximum number of HOSE-listed stocks to return. The Ho Chi Minh Stock Exchange has roughly 400 listed companies. Use 10 for a smoke test, 30 for the VN30 blue-chip index, or 400 to pull the entire HOSE universe. Records are returned sorted by market cap (in billion VND) descending so the most liquid Vietnamese blue-chips like VIC, VHM, VCB, HPG, VNM come first.",
                        "default": 100
                    },
                    "market": {
                        "title": "Market segment",
                        "enum": [
                            "HOSE-all",
                            "VN30"
                        ],
                        "type": "string",
                        "description": "Which HOSE segment to scrape. 'HOSE-all' covers every Ho Chi Minh Stock Exchange common-stock listing (~400 tickers). 'VN30' restricts to the VN30 blue-chip index — the 30 largest, most liquid Vietnamese companies (VIC Vingroup, VHM Vinhomes, VCB Vietcombank, HPG Hoa Phat Group, VNM Vinamilk, BID BIDV, CTG VietinBank, TCB Techcombank, MSN Masan, MWG Mobile World, etc.). VN30 is the most-tracked benchmark for Vietnamese equities and the underlying for VN30 futures on HNX.",
                        "default": "HOSE-all"
                    },
                    "min_market_cap_vnd_billion": {
                        "title": "Min market cap (billion VND)",
                        "minimum": 0,
                        "maximum": 100000000,
                        "type": "integer",
                        "description": "Filter to stocks with market cap at or above this value, expressed in BILLION Vietnamese Dong (1 billion VND ≈ 40,000 USD at current rates). Examples: 1000 = 1 trillion VND (mid-cap), 10000 = 10 trillion VND (large-cap), 100000 = 100 trillion VND (VN30 mega-cap tier). Leave at 0 for no filter. VND market caps are quoted directly off the stockanalysis.com list view and converted from trillion-VND notation (e.g. '1,694.72T') to billion units.",
                        "default": 0
                    },
                    "sector": {
                        "title": "Sector / industry keyword",
                        "type": "string",
                        "description": "Optional case-insensitive substring filter applied to the company name and industry classification. Examples: 'bank' (Vietnamese banks like VCB, BID, CTG, TCB), 'real estate' (VIC, VHM, NVL, KDH), 'food' (VNM Vinamilk, MSN Masan), 'steel' (HPG Hoa Phat), 'retail' (MWG Mobile World, PNJ), 'oil' (PLX Petrolimex, GAS PetroVietnam Gas), 'utilities', 'logistics'. Leave blank to disable filtering."
                    },
                    "include_fundamentals": {
                        "title": "Enrich with fundamentals (P/E, P/B, EPS, beta)",
                        "type": "boolean",
                        "description": "If true, fetch each stock's individual quote page to enrich it with P/E ratio, P/B ratio (computed when book value available), EPS, beta, RSI, 52-week range, average volume, shares outstanding, sector/industry, dividend yield, ex-dividend date. This roughly doubles runtime since one extra HTTP request is needed per ticker. Recommended ON for institutional research; turn OFF for fast price-only scrapes of the full universe.",
                        "default": true
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Apify proxy configuration. stockanalysis.com tolerates datacenter proxies fine; switch to RESIDENTIAL only if you hit Cloudflare challenges when scraping the full 400-ticker universe with fundamentals enabled.",
                        "default": {
                            "useApifyProxy": true
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```