# Wallet stops · HyperCore API · Femtos

> One wallet's open trigger orders, or with history=1 every status event of them.

- 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/wallet-stops

## Wallet stops — GET `/v1/hypercore/wallet/{address}/stops`

One wallet's open trigger orders, or with history=1 every status event of them.

| Param | In | Example or values | Meaning |
|---|---|---|---|
| `address` | path | `<address>` | 0x address, or a named wallet's handle <entityId>.<hex> |
| `history` | query | `(empty)`, `1` | 1: past status events instead of the open orders (heavy call) |
| `limit` | query | `100` | history: events |
| `cursor` | query | (optional) | Next page: `next_cursor` of the previous answer |

```bash
curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/hypercore/wallet/<address>/stops?limit=100"
```

| Field | Type | Meaning |
|---|---|---|
| `orders[]` | object | Open trigger orders, newest placed first: {oid, user, coin, side, kind, exec, orderType, triggerPx, triggerCondition, limitPx, sz, origSz, …} |
| `count` | int | Orders listed |
| `truncated` | boolean | More than 1000 open trigger orders: the newest 1000 listed |
| `events[]` | object | Status events, newest first: {oid, user, coin, side, kind, exec, orderType, triggerPx, triggerCondition, limitPx, sz, origSz, …} |
| `since` | ms | Window start read |
| `until` | ms | Window end |
| `entity` | object | Named wallet (labels), when known |
| `next_cursor` | string \| null | Opaque cursor of the next page: pass it as `cursor`, unchanged. null on the last page |
| `billing` | heavy | heavy with history |

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.
- [Triggered stops](https://femtos.xyz/hypercore/stops-triggered.md): Stop-loss and take-profit orders that fired, newest first, with the fill they got.
- [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