---
title: "Wallet trigger orders"
method: GET
path: "/api/public/v1/pulse/trader/{address}/trigger-orders"
tags: ["Pulse"]
---

# Wallet trigger orders

`GET /api/public/v1/pulse/trader/{address}/trigger-orders`

## Request

- Base URL: `https://api.coinversa.ai`
- URL: `https://api.coinversa.ai/api/public/v1/pulse/trader/{address}/trigger-orders`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/coinversa/apis/coinversa-api/docs/api/public/v1/pulse/trader/:address/trigger-orders/get.ts> (a function with typed inputs; its response is checked against the schema)

Individual untriggered stop/take-profit orders for this exact wallet across markets, optionally filtered by case-sensitive coin. Ordered by coin and order ID. Latest-only exchange-wide snapshot, refreshed roughly every minute. Available snapshots return HTTP 200 with stale=true when age_s > 1200, otherwise stale=false. Missing snapshots return 503. No trader registration or related-subaccount lookup is required; a wallet with no matching orders returns an empty list. Pagination uses limit/offset and snapshot_height; changed snapshots require restarting.

## Path parameters

- `address` string, required: 0x-prefixed 20-byte wallet address; queries this wallet only, not related subaccounts.

## Query parameters

- `limit` integer
- `offset` integer
- `snapshot_height` integer: For subsequent pages, supply the first page's as_of_height. Required when offset > 0. A replaced snapshot returns 409; restart from offset 0.
- `coin` string: Optional case-sensitive node symbol. Omit to return this wallet's triggers across all markets.

## Response `200`

OK

- TriggerOrdersBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `address` string
  - `age_s` integer, required
  - `as_of_block_time` string, required
  - `as_of_height` integer, required
  - `coin` string
  - `has_more` boolean, required
  - `limit` integer, required
  - `offset` integer, required
  - `orders` TriggerOrder[], nullable, required
    - `address` string, required
    - `cloid` string, nullable, required
    - `coin` string, required
    - `is_position_tpsl` boolean, required
    - `limit_px` string, required
    - `oid` integer, required
    - `order_type` string, required
    - `orig_size` string, required
    - `placed_at` integer, required: Order placement time, Unix milliseconds UTC.
    - `reduce_only` boolean, required
    - `side` string, required: B = buy, A = sell; not a position's long/short direction.
    - `size` string, required
    - `trigger_px` string, required
  - `source` string, required
  - `stale` boolean, required: True when age_s > 1200. Stale snapshots are still returned with HTTP 200.

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `409`: Conflict
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable
- `504`: Gateway Timeout

## Changes

- **2026-10-21** `3454317a5830`: 1 info
  - added the required property `stale` to the response with the `200` status
- **2026-10-14** `e668ee30bd24`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/coinversa/apis/coinversa-api/changes/api/public/v1/pulse/trader/:address/trigger-orders/get.md)

---

[API](https://skmtc.dev/coinversa/apis/coinversa-api.md) - [All operations](https://skmtc.dev/coinversa/apis/coinversa-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coinversa/apis/coinversa-api/revisions/3454317a5830?raw)