# orders.status

Check the live state of a specific Polymarket limit order by its order_id. Use after orders.buy, orders.batch, or wta.bid to track fill progress, or to verify that an orders.cancel call succeeded. Returns the order status (OPEN, FILLED, CANCELLED, or EXPIRED), filled amount, remaining size, current limit price, and the market it was placed on. Obtain the order_id from the response of the placing tool or from orders.list. Only works in live mode.

Agent View of the PolicyLayer registry record for `orders.status`. HTML page: https://policylayer.com/tools/demwick-polymarket-agent-mcp/orders.status

## Facts

- Tool: `orders.status`
- Server: Polymarket Agent Mcp (`demwick/polymarket-agent-mcp`) — https://policylayer.com/tools/demwick-polymarket-agent-mcp.md
- Homepage: https://github.com/demwick/polymarket-agent-mcp
- Risk category: Read (Low risk)
- Registry record: grade F, identity unverified
- Server rate-limited: no
- Parameters: 0
- Recommended policy verdict: Allowed

## Example call (MCP tools/call, JSON-RPC 2.0)

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "orders.status",
    "arguments": {}
  }
}
```

## Why orders.status is rated Low

This tool only retrieves and returns status information about an existing order. It does not create, modify, cancel, or execute anything — it is a pure read/query operation. Severity is low as misuse only exposes order status data.

From the tool's own definition: "Check the live state of a specific Polymarket limit order... Returns the order status (OPEN, FILLED, CANCELLED, or EXPIRED), filled amount, remaining size, current limit price"

## Use case

AI agents call orders.status to retrieve information from Polymarket Agent Mcp without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

## Recommended policy (PolicyLayer)

Verdict: **Allowed**. Enforced by the PolicyLayer MCP gateway (https://policylayer.com/mcp-gateway) before a call reaches Polymarket Agent Mcp:

```json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "orders.status": {}
  }
}
```

## Other tools on Polymarket Agent Mcp (47)

- `orders.cancel` — Destructive — https://policylayer.com/tools/demwick-polymarket-agent-mcp/orders.cancel.md
- `watchlist.rebalance` — Destructive — https://policylayer.com/tools/demwick-polymarket-agent-mcp/watchlist.rebalance.md
- `monitor.start` — Execute — https://policylayer.com/tools/demwick-polymarket-agent-mcp/monitor.start.md
- `monitor.stop` — Execute — https://policylayer.com/tools/demwick-polymarket-agent-mcp/monitor.stop.md
- `traders.backtest` — Execute — https://policylayer.com/tools/demwick-polymarket-agent-mcp/traders.backtest.md
- `config.go_live` — Financial — https://policylayer.com/tools/demwick-polymarket-agent-mcp/config.go-live.md
- `orders.batch` — Financial — https://policylayer.com/tools/demwick-polymarket-agent-mcp/orders.batch.md
- `orders.buy` — Financial — https://policylayer.com/tools/demwick-polymarket-agent-mcp/orders.buy.md
- `orders.sell` — Financial — https://policylayer.com/tools/demwick-polymarket-agent-mcp/orders.sell.md
- `positions.check_exits` — Financial — https://policylayer.com/tools/demwick-polymarket-agent-mcp/positions.check-exits.md
- `positions.close` — Financial — https://policylayer.com/tools/demwick-polymarket-agent-mcp/positions.close.md
- `wta.bid` — Financial — https://policylayer.com/tools/demwick-polymarket-agent-mcp/wta.bid.md
- `agent.log_cycle` — Read — https://policylayer.com/tools/demwick-polymarket-agent-mcp/agent.log-cycle.md
- `dashboard.get` — Read — https://policylayer.com/tools/demwick-polymarket-agent-mcp/dashboard.get.md
- `flow.discover` — Read — https://policylayer.com/tools/demwick-polymarket-agent-mcp/flow.discover.md
- `markets.analyze` — Read — https://policylayer.com/tools/demwick-polymarket-agent-mcp/markets.analyze.md
- `markets.arbitrage` — Read — https://policylayer.com/tools/demwick-polymarket-agent-mcp/markets.arbitrage.md
- `markets.check` — Read — https://policylayer.com/tools/demwick-polymarket-agent-mcp/markets.check.md
- `markets.compare` — Read — https://policylayer.com/tools/demwick-polymarket-agent-mcp/markets.compare.md
- `markets.discover` — Read — https://policylayer.com/tools/demwick-polymarket-agent-mcp/markets.discover.md
- `markets.events` — Read — https://policylayer.com/tools/demwick-polymarket-agent-mcp/markets.events.md
- `markets.featured` — Read — https://policylayer.com/tools/demwick-polymarket-agent-mcp/markets.featured.md
- `markets.holders` — Read — https://policylayer.com/tools/demwick-polymarket-agent-mcp/markets.holders.md
- `markets.price` — Read — https://policylayer.com/tools/demwick-polymarket-agent-mcp/markets.price.md
- `markets.price_history` — Read — https://policylayer.com/tools/demwick-polymarket-agent-mcp/markets.price-history.md
- `markets.related` — Read — https://policylayer.com/tools/demwick-polymarket-agent-mcp/markets.related.md
- `markets.search` — Read — https://policylayer.com/tools/demwick-polymarket-agent-mcp/markets.search.md
- `markets.trending` — Read — https://policylayer.com/tools/demwick-polymarket-agent-mcp/markets.trending.md
- `markets.watch_price` — Read — https://policylayer.com/tools/demwick-polymarket-agent-mcp/markets.watch-price.md
- `orders.list` — Read — https://policylayer.com/tools/demwick-polymarket-agent-mcp/orders.list.md
- …and 17 more: https://policylayer.com/tools/demwick-polymarket-agent-mcp.md

## For agents

This record is a snapshot. Live verdicts and the full registry:

- Check every server in your MCP config at once: `npx -y policylayer stack`
- Vet a server before you add it: install the mcp-precheck skill — `npx skills add https://policylayer.com` (skill text: https://policylayer.com/skill.md)
- Query the registry over MCP: endpoint `https://api.policylayer.com/mcp` — tools `check_mcp_server`, `check_mcp_stack`, `check_tool`, `search_registry`, `get_change_events`

---

Source: the PolicyLayer MCP registry — one continuously verified record per MCP server. Full record: https://policylayer.com/registry?q=demwick-polymarket-agent-mcp · API: https://policylayer.com/registry/api · Policy library: https://policylayer.com/policies/demwick-polymarket-agent-mcp