# Triggered stops · HyperCore API · Femtos

> Stop-loss and take-profit orders that fired, newest first, with the fill they got.

- Base URL: `https://api.femtos.xyz/v1` (REST) · `wss://api.femtos.xyz/v1/ws` (WebSocket) · MCP: `https://api.femtos.xyz/mcp`
- Auth: `Authorization: Bearer $FEMTOS_KEY`. Free key: https://femtos.xyz/accounts/ (browser), or with
  no browser: `GET https://femtos.xyz/accounts/agent/challenge`, solve its proof of work, then `POST https://femtos.xyz/accounts/agent/signup`
  (https://femtos.xyz/agents.md#agent-onboarding)
- Decimals are exact strings, times Unix milliseconds, addresses lowercase `0x`
- Whole API in one file: https://femtos.xyz/agents.md · OpenAPI: https://api.femtos.xyz/v1/openapi.json · Index: https://femtos.xyz/llms.txt
- Page with live calls: https://femtos.xyz/hypercore/stops-triggered

## Triggered stops — GET `/v1/hypercore/stops/triggered`

Stop-loss and take-profit orders that fired, newest first, with the fill they got.

| Param | In | Example or values | Meaning |
|---|---|---|---|
| `coin` | query | `BTC` | HyperCore coin |
| `since` | query | (optional) | Window start (Unix ms, default until − 1 h) |
| `until` | query | (optional) | Window end (Unix ms, exclusive, default now) |
| `limit` | query | `100` | Rows |
| `cursor` | query | (optional) | Next page: `next_cursor` of the previous answer |

```bash
curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/hypercore/stops/triggered?coin=BTC&limit=100"
```

| Field | Type | Meaning |
|---|---|---|
| `events` | object[] | Newest first: {oid, user, coin, side, kind, exec, orderType, triggerPx, triggerCondition, limitPx, sz, origSz, …} |
| `events.triggeredAt` | ms | When it fired (= statusTime) |
| `events.child` | object \| null | The order the trigger placed: its status in the trigger block (filled, open, canceled…), size, limit price: {status, sz, limitPx} |
| `events.fill` | object \| null | Fills of that order in the trigger block; null when none: {sz, avgPx, notional, fills} |
| `since` | ms | Window start read |
| `until` | ms | Window end |
| `next_cursor` | string \| null | Opaque cursor of the next page: pass it as `cursor`, unchanged. null on the last page |

Next page: `cursor` = the `next_cursor` of the previous answer (https://femtos.xyz/agents.md#pagination).

## Related (Stops & take-profits)

- [Stop map](https://femtos.xyz/hypercore/stops.md): Open stop-loss and take-profit orders of one coin, bucketed by trigger price around the mark.
- [Wallet stops](https://femtos.xyz/hypercore/wallet-stops.md): One wallet's open trigger orders, or with history=1 every status event of them.
- [Stops stream](https://femtos.xyz/hypercore/ws-stops.md): Every trigger order event: placed, triggered, canceled, and the order a trigger placed.

All HyperCore endpoints: https://femtos.xyz/hypercore.md