# Webull Market Data

> Retrieve read-only Webull Thailand market, instrument, analyst, and screener data for research and monitoring. Use for prices, quotes, bars, profiles, ratings, target prices, gainers-losers, or top-active lists; never treat the result as a trading instruction.

- **Type:** Skill
- **Install:** `agentstack add skill-nutdnuy-webull-openapi-ai-plugin-webull-market-data`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [nutdnuy](https://agentstack.voostack.com/s/nutdnuy)
- **Installs:** 0
- **Category:** [Finance & Payments](https://agentstack.voostack.com/c/finance-and-payments)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [nutdnuy](https://github.com/nutdnuy)
- **Source:** https://github.com/nutdnuy/webull-openapi-AI-Plugin/tree/main/skills/webull-market-data

## Install

```sh
agentstack add skill-nutdnuy-webull-openapi-ai-plugin-webull-market-data
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Webull market data

Read the relevant endpoint object in `references/endpoints.json`, follow its `schema_ref` into `references/openapi.json`, and use `references/authentication.md` for headers/signatures before every request. Consult the official [Webull Open API reference](https://developer.webull.co.th/apis/docs/webull-open-api-reference) for endpoint documentation and permissions.

## First-use onboarding

Before the first data request, check for `WEBULL_APP_KEY` and `WEBULL_APP_SECRET` in the configured environment or secret manager. If the API Key is missing, ask the user to configure it securely and stop before any network request. Never request credentials pasted into chat.

## Supported read-only endpoints

All paths below are read-only data operations; use the official reference index linked above for the current method, parameters, response, and rate limit.

- `/openapi/market-data/stock/tick`
- `/openapi/market-data/stock/snapshot`
- `/openapi/market-data/stock/quotes`
- `/openapi/market-data/stock/footprint`
- `/openapi/market-data/stock/batch-bars`
- `/openapi/market-data/stock/bars`
- `/openapi/instrument/stock/list`
- `/openapi/instrument/company/profile`
- `/openapi/instrument/analyst/rating`
- `/openapi/instrument/analyst/target-price`
- `/openapi/market-data/screener/gainers-losers`
- `/openapi/market-data/screener/top-active`

## Request workflow

1. Identify the exact path and read its catalog entry. Construct query parameters, path parameters, and JSON body exactly as cataloged; do not guess symbol, market, timestamp, pagination, or batch shapes.
2. Invoke the shared client and preserve its structured response:

   ```bash
   python scripts/webull_api.py request --method GET --path /openapi/market-data/stock/snapshot --query-json '{"symbol":"","market":""}'
   ```

   For a cataloged POST such as batch bars, use the catalog-shaped body:

   ```bash
   python scripts/webull_api.py request --method POST --path /openapi/market-data/stock/batch-bars --body-file ./batch-bars.json
   ```

3. Require only the minimum identifiers and account context documented for that endpoint. Validate dates, symbols, intervals, and pagination before calling. For batches, keep the requested universe and time range explicit.
4. Label output as observed API data with its timestamp and environment. Report empty, partial, stale, permission, rate-limit, and error responses without filling gaps from memory.
5. Keep this skill read-only. Do not call watchlist or order endpoints, and do not infer buy/sell/hold instructions, price targets, or execution decisions from market data. Historical or analyst fields are research inputs, not forecasts or guarantees.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [nutdnuy](https://github.com/nutdnuy)
- **Source:** [nutdnuy/webull-openapi-AI-Plugin](https://github.com/nutdnuy/webull-openapi-AI-Plugin)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-nutdnuy-webull-openapi-ai-plugin-webull-market-data
- Seller: https://agentstack.voostack.com/s/nutdnuy
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.