Empezar

Endpoints · Listas de seguimiento

Update a watchlist

Esta referencia está en inglés. La navegación y las etiquetas están traducidas.

Renames or pins a watchlist, or adds and removes instruments in one atomic step.

PATCH/api/v1/watchlists/{id}

Alcance: watchlists:write

Parámetros

Parámetros de ruta

  • idstringrutaobligatorio

    Watchlist id, "wl_…".

Cuerpo

  • namestringcuerpo

    New name.

  • addstring[]cuerpo

    Instrument ids to add.

  • removestring[]cuerpo

    Instrument ids to remove.

  • instrument_idsstring[]cuerpo

    Replaces the whole list.

  • pinnedbooleancuerpo

    Pin or unpin.

Solicitud
curl -X PATCH https://yieldsniper.finance/api/v1/watchlists/wl_6adccafe1c9b331c1d1bbfcc \
  -H "Authorization: Bearer $YS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "add": ["ins_0abd5ec576be07e6"],
    "remove": ["ins_2f32db0cbfbb54dd"]
  }'
Respuesta200
{
  "object": "watchlist",
  "id": "wl_6adccafe1c9b331c1d1bbfcc",
  "name": "Treasury candidates",
  "instrument_ids": ["ins_4c29f40abec73e1b", "ins_0abd5ec576be07e6"],
  "pinned": false,
  "created_at": "2026-10-24T15:13:02.567Z",
  "updated_at": "2026-10-24T15:13:03.813Z"
}

Devuelve

The updated watchlist.

Objeto: Watchlist