--- title: "List position moves, copy starts and chart notes across a scope" method: GET path: "/v1/positions/activity" tags: ["positions"] --- # List position moves, copy starts and chart notes across a scope `GET /v1/positions/activity` ## Query parameters - `limit` integer - `cursor` string - `scope` 'everyone' | 'following' | 'clan' - `kinds` ActivityItemKind[] ## Response `200` Successful response - PositionsActivityOutput - `total` integer - `nextCursor` string - `previousCursor` string - `hasMore` boolean, required - `items` ActivityItem[], required - union - object - `move` PositionMove, required - `id` string, required - `twap` TwapExecutionSummary - `id` string, required - `fill_count` integer, required - `started_at` string, required - `last_executed_at` string, required - `action` 'opened' | 'added' | 'reduced' | 'closed' | 'flipped', required - `symbol` string, required - `side` 'LONG' | 'SHORT', required - `previous_side` 'LONG' | 'SHORT', nullable, required - `size` number, required - `price` number, required - `notional_usd` number, required - `realized_pnl` number, required - `before_size` number, nullable, required - `after_size` number, nullable, required - `leverage_value` number, nullable, required - `executed_at` string, required - `fills` PositionMoveFill[], required - `fill_id` string, required - `order_id` string, required - `direction` string, nullable, required - `side` 'LONG' | 'SHORT', required - `size` number, required - `price` number, required - `notional_usd` number, required - `closed_pnl` number, required - `start_position` number, nullable, required - `executed_at` string, required - `position` PositionMovePosition, required - `id` string, required - `symbol` string, required - `side` 'LONG' | 'SHORT', required - `size` number, required - `entry_price` number, required - `leverage_value` integer, required - `unrealized_pnl` number, required - `realized_pnl` number, required - `notional_usd` number, nullable, required - `margin_used` number, nullable, required - `opened_at` string, required - `closed_at` string, nullable, required - `activity_at` string, required - `pnlSparkline` SparklinePoint[], required - `t` number, required - `v` number, required - `closed_price` number, nullable, required - `trader` AvatarUser, required - `id` string, required - `username` string, required - `display_name` string, required - `avatar_url` string, required - `rank` integer, nullable, required - `clan_id` string, nullable, required - `clan` UserClan, nullable - `id` string, required - `name` string, required - `description` string, nullable, required - `image_url` string, nullable, required - `banner_url` string, nullable, required - `chat_room_id` string, nullable, required - `created_at` string, required - `updated_at` string, required - `account_value_tier` integer, required - `is_official` boolean, required - `copyTarget` AvatarUser, required - `id` string, required - `username` string, required - `display_name` string, required - `avatar_url` string, required - `rank` integer, nullable, required - `clan_id` string, nullable, required - `clan` UserClan, nullable - `id` string, required - `name` string, required - `description` string, nullable, required - `image_url` string, nullable, required - `banner_url` string, nullable, required - `chat_room_id` string, nullable, required - `created_at` string, required - `updated_at` string, required - `account_value_tier` integer, required - `is_official` boolean, required - `copyDetails` BoardCopyDetails, required - `amount` number, required - `margin` number, required - `leverage` number, required - `entry_price` number, nullable, required - `copied_at` string, required - `copiedByViewer` boolean, required - `copiers` AvatarUser[], required - `id` string, required - `username` string, required - `display_name` string, required - `avatar_url` string, required - `rank` integer, nullable, required - `clan_id` string, nullable, required - `clan` UserClan, nullable - `id` string, required - `name` string, required - `description` string, nullable, required - `image_url` string, nullable, required - `banner_url` string, nullable, required - `chat_room_id` string, nullable, required - `created_at` string, required - `updated_at` string, required - `account_value_tier` integer, required - `is_official` boolean, required - `copiedCount` integer, required - `type` 'move', required - object - `type` 'copy_start', required - `id` string, required - `copier` AvatarUser, required - `id` string, required - `username` string, required - `display_name` string, required - `avatar_url` string, required - `rank` integer, nullable, required - `clan_id` string, nullable, required - `clan` UserClan, nullable - `id` string, required - `name` string, required - `description` string, nullable, required - `image_url` string, nullable, required - `banner_url` string, nullable, required - `chat_room_id` string, nullable, required - `created_at` string, required - `updated_at` string, required - `account_value_tier` integer, required - `is_official` boolean, required - `target` AvatarUser, required - `id` string, required - `username` string, required - `display_name` string, required - `avatar_url` string, required - `rank` integer, nullable, required - `clan_id` string, nullable, required - `clan` UserClan, nullable - `id` string, required - `name` string, required - `description` string, nullable, required - `image_url` string, nullable, required - `banner_url` string, nullable, required - `chat_room_id` string, nullable, required - `created_at` string, required - `updated_at` string, required - `account_value_tier` integer, required - `is_official` boolean, required - `amount` number, required - `started_at` string, required - object - `type` 'note', required - `note` PositionMoveNote, required - `id` string, uuid, required - `user_id` string, uuid, required - `type` 'chart_note' | 'standalone' | 'position_opened' | 'position_closed' | 'position_added' | 'position_reduced' | 'position_flipped' | 'copy_trade' | 'recap', required - `content` string, nullable, required - `chart_symbol` string, nullable, required - `chart_timestamp` string, nullable, required - `position_id` string, uuid, nullable, required - `order_id` string, nullable, required - `network` string, nullable, required - `clan_id` string, uuid, nullable, required - `clan` PostClan, required - `id` string, uuid, required - `name` string, required - `description` string, nullable, required - `image_url` string, nullable, required - `banner_url` string, nullable, required - `chat_room_id` string, uuid, nullable, required - `created_at` string, required - `updated_at` string, required - `like_count` integer, required - `comment_count` integer, required - `chat_room_id` string, uuid, nullable, required - `created_at` string, required - `updated_at` string, required - `copied_user_id` string, uuid, nullable, required - `copiedUser` FeedUser, required - `id` string, required - `username` string, required - `display_name` string, required - `avatar_url` string, required - `rank` integer, nullable, required - `clan_id` string, nullable, required - `clan` UserClan, nullable - … - `account_value_tier` integer, required - `is_official` boolean, required - `bio` string, nullable, required - `wallet_address` string, nullable, required - `copied_count` integer, required - `copiers` FeedUser[], required - `id` string, required - `username` string, required - `display_name` string, required - `avatar_url` string, required - `rank` integer, nullable, required - `clan_id` string, nullable, required - `clan` UserClan, nullable - … - `account_value_tier` integer, required - `is_official` boolean, required - `bio` string, nullable, required - `wallet_address` string, nullable, required - `user` FeedUser, required - `id` string, required - `username` string, required - `display_name` string, required - `avatar_url` string, required - `rank` integer, nullable, required - `clan_id` string, nullable, required - `clan` UserClan, nullable - … - `account_value_tier` integer, required - `is_official` boolean, required - `bio` string, nullable, required - `wallet_address` string, nullable, required - `attachments` PostAttachment[], required - `id` string, uuid, required - `type` 'image' | 'video' | 'file' | 'audio' | 'gif' | 'sticker', required - `url` string, nullable, required - `external_url` string, nullable, required - `filename` string, required - `mime_type` string, required - `width` integer, nullable, required - `height` integer, nullable, required - `blur_hash` string, nullable, required - `duration` number, nullable, required - `thumbnail_url` string, nullable, required - `is_liked` boolean, required - `tradingMetadata` TradingMetadata - `id` string, uuid, required - `symbol` string, required - `side` 'LONG' | 'SHORT', required - `entry_price` number, required - `size` number, required - `leverage_type` string, required - `leverage_value` integer, required - `realized_pnl` number, required - `unrealized_pnl` number, required - `isOpen` boolean, required - `opened_at` string, required - `closed_at` string, nullable, required - `closed_price` number, nullable, required - `pnlSparkline` SparklinePoint[], required - … - `mentioned_users` FeedMentionedUser[], required - `id` string, required - `username` string, required - `display_name` string, required - `avatar_url` string, required - `bio` string, nullable, required - `mentioned_clans` MentionedClan[] - `id` string, required - `name` string, required - `image_url` string, nullable, required - `mentioned_symbols` string[] - `link_preview` LinkPreview - `url` string, required - `title` string, nullable, required - `description` string, nullable, required - `image` string, nullable, required - `imageWidth` integer, nullable, required - `imageHeight` integer, nullable, required - `imageRole` 'avatar' | 'content' | 'unknown' - `isPlayable` boolean - `siteName` string, nullable, required - `favicon` string, nullable, required - `recap_content` RecapContent - `date` string, required - `summary` string, required - `sections` RecapSection[], required - … - `citations` RecapCitation[] - … - `searchEntryPointHtml` string - `translations` object - … - `quoted_post` FeedBasePost - `id` string, uuid, required - `user_id` string, uuid, required - `type` 'chart_note' | 'standalone' | 'position_opened' | 'position_closed' | 'position_added' | 'position_reduced' | 'position_flipped' | 'copy_trade' | 'recap', required - `content` string, nullable, required - `chart_symbol` string, nullable, required - `chart_timestamp` string, nullable, required - `position_id` string, uuid, nullable, required - `order_id` string, nullable, required - `network` string, nullable, required - `clan_id` string, uuid, nullable, required - `clan` PostClan, required - … - `like_count` integer, required - `comment_count` integer, required - `chat_room_id` string, uuid, nullable, required - `created_at` string, required - `updated_at` string, required - `copied_user_id` string, uuid, nullable, required - `copiedUser` FeedUser, required - … - `copied_count` integer, required - `copiers` FeedUser[], required - … - `user` FeedUser, required - … - `attachments` PostAttachment[], required - … - `is_liked` boolean, required - `tradingMetadata` TradingMetadata - … - `mentioned_users` FeedMentionedUser[], required - … - `mentioned_clans` MentionedClan[] - … - `mentioned_symbols` string[] - `link_preview` LinkPreview - … - `recap_content` RecapContent - … - `recent_replies` PostReplyPreview[] - `id` string, uuid, required - `user` AvatarUser, required - … - `content` string, nullable, required - `created_at` string, required - `like_count` integer, required - `is_liked` boolean, required - `attachments` PostAttachment[], required - … - `position` ActivityNotePosition, required - `id` string, required - `symbol` string, required - `side` 'LONG' | 'SHORT', required - `size` number, required - `entry_price` number, required - `leverage_value` integer, required - `unrealized_pnl` number, required - `realized_pnl` number, required - `notional_usd` number, nullable, required - `margin_used` number, nullable, required - `opened_at` string, required - `closed_at` string, nullable, required - `activity_at` string, required - `pnlSparkline` SparklinePoint[], required - `t` number, required - `v` number, required - `closed_price` number, nullable, required - `trader` AvatarUser, required - `id` string, required - `username` string, required - `display_name` string, required - `avatar_url` string, required - `rank` integer, nullable, required - `clan_id` string, nullable, required - `clan` UserClan, nullable - `id` string, required - `name` string, required - `description` string, nullable, required - `image_url` string, nullable, required - `banner_url` string, nullable, required - `chat_room_id` string, nullable, required - `created_at` string, required - `updated_at` string, required - `account_value_tier` integer, required - `is_official` boolean, required - object - `type` 'quote', required - `post` PositionMoveNote, required - `id` string, uuid, required - `user_id` string, uuid, required - `type` 'chart_note' | 'standalone' | 'position_opened' | 'position_closed' | 'position_added' | 'position_reduced' | 'position_flipped' | 'copy_trade' | 'recap', required - `content` string, nullable, required - `chart_symbol` string, nullable, required - `chart_timestamp` string, nullable, required - `position_id` string, uuid, nullable, required - `order_id` string, nullable, required - `network` string, nullable, required - `clan_id` string, uuid, nullable, required - `clan` PostClan, required - `id` string, uuid, required - `name` string, required - `description` string, nullable, required - `image_url` string, nullable, required - `banner_url` string, nullable, required - `chat_room_id` string, uuid, nullable, required - `created_at` string, required - `updated_at` string, required - `like_count` integer, required - `comment_count` integer, required - `chat_room_id` string, uuid, nullable, required - `created_at` string, required - `updated_at` string, required - `copied_user_id` string, uuid, nullable, required - `copiedUser` FeedUser, required - `id` string, required - `username` string, required - `display_name` string, required - `avatar_url` string, required - `rank` integer, nullable, required - `clan_id` string, nullable, required - `clan` UserClan, nullable - … - `account_value_tier` integer, required - `is_official` boolean, required - `bio` string, nullable, required - `wallet_address` string, nullable, required - `copied_count` integer, required - `copiers` FeedUser[], required - `id` string, required - `username` string, required - `display_name` string, required - `avatar_url` string, required - `rank` integer, nullable, required - `clan_id` string, nullable, required - `clan` UserClan, nullable - … - `account_value_tier` integer, required - `is_official` boolean, required - `bio` string, nullable, required - `wallet_address` string, nullable, required - `user` FeedUser, required - `id` string, required - `username` string, required - `display_name` string, required - `avatar_url` string, required - `rank` integer, nullable, required - `clan_id` string, nullable, required - `clan` UserClan, nullable - … - `account_value_tier` integer, required - `is_official` boolean, required - `bio` string, nullable, required - `wallet_address` string, nullable, required - `attachments` PostAttachment[], required - `id` string, uuid, required - `type` 'image' | 'video' | 'file' | 'audio' | 'gif' | 'sticker', required - `url` string, nullable, required - `external_url` string, nullable, required - `filename` string, required - `mime_type` string, required - `width` integer, nullable, required - `height` integer, nullable, required - `blur_hash` string, nullable, required - `duration` number, nullable, required - `thumbnail_url` string, nullable, required - `is_liked` boolean, required - `tradingMetadata` TradingMetadata - `id` string, uuid, required - `symbol` string, required - `side` 'LONG' | 'SHORT', required - `entry_price` number, required - `size` number, required - `leverage_type` string, required - `leverage_value` integer, required - `realized_pnl` number, required - `unrealized_pnl` number, required - `isOpen` boolean, required - `opened_at` string, required - `closed_at` string, nullable, required - `closed_price` number, nullable, required - `pnlSparkline` SparklinePoint[], required - … - `mentioned_users` FeedMentionedUser[], required - `id` string, required - `username` string, required - `display_name` string, required - `avatar_url` string, required - `bio` string, nullable, required - `mentioned_clans` MentionedClan[] - `id` string, required - `name` string, required - `image_url` string, nullable, required - `mentioned_symbols` string[] - `link_preview` LinkPreview - `url` string, required - `title` string, nullable, required - `description` string, nullable, required - `image` string, nullable, required - `imageWidth` integer, nullable, required - `imageHeight` integer, nullable, required - `imageRole` 'avatar' | 'content' | 'unknown' - `isPlayable` boolean - `siteName` string, nullable, required - `favicon` string, nullable, required - `recap_content` RecapContent - `date` string, required - `summary` string, required - `sections` RecapSection[], required - … - `citations` RecapCitation[] - … - `searchEntryPointHtml` string - `translations` object - … - `quoted_post` FeedBasePost - `id` string, uuid, required - `user_id` string, uuid, required - `type` 'chart_note' | 'standalone' | 'position_opened' | 'position_closed' | 'position_added' | 'position_reduced' | 'position_flipped' | 'copy_trade' | 'recap', required - `content` string, nullable, required - `chart_symbol` string, nullable, required - `chart_timestamp` string, nullable, required - `position_id` string, uuid, nullable, required - `order_id` string, nullable, required - `network` string, nullable, required - `clan_id` string, uuid, nullable, required - `clan` PostClan, required - … - `like_count` integer, required - `comment_count` integer, required - `chat_room_id` string, uuid, nullable, required - `created_at` string, required - `updated_at` string, required - `copied_user_id` string, uuid, nullable, required - `copiedUser` FeedUser, required - … - `copied_count` integer, required - `copiers` FeedUser[], required - … - `user` FeedUser, required - … - `attachments` PostAttachment[], required - … - `is_liked` boolean, required - `tradingMetadata` TradingMetadata - … - `mentioned_users` FeedMentionedUser[], required - … - `mentioned_clans` MentionedClan[] - … - `mentioned_symbols` string[] - `link_preview` LinkPreview - … - `recap_content` RecapContent - … - `recent_replies` PostReplyPreview[] - `id` string, uuid, required - `user` AvatarUser, required - … - `content` string, nullable, required - `created_at` string, required - `like_count` integer, required - `is_liked` boolean, required - `attachments` PostAttachment[], required - … - `position` ActivityQuotePosition, required - `id` string, required - `symbol` string, required - `side` 'LONG' | 'SHORT', required - `size` number, required - `entry_price` number, required - `leverage_value` integer, required - `unrealized_pnl` number, required - `realized_pnl` number, required - `notional_usd` number, nullable, required - `margin_used` number, nullable, required - `opened_at` string, required - `closed_at` string, nullable, required - `activity_at` string, required - `closed_price` number, nullable, required - `trader` AvatarUser, required - `id` string, required - `username` string, required - `display_name` string, required - `avatar_url` string, required - `rank` integer, nullable, required - `clan_id` string, nullable, required - `clan` UserClan, nullable - `id` string, required - `name` string, required - `description` string, nullable, required - `image_url` string, nullable, required - `banner_url` string, nullable, required - `chat_room_id` string, nullable, required - `created_at` string, required - `updated_at` string, required - `account_value_tier` integer, required - `is_official` boolean, required ## Other responses - `400` — Invalid input data - `404` — Resource not found - `500` — Internal server error ## Changes - **2026-09-24** `5191b5396145` — 1 breaking, 2 info - added `#/components/schemas/ActivityQuoteItem` to the `items/items/` response property `oneOf` list for the response status `200` - added the enum value `quote` to the property `items/` of the `query` request parameter `kinds` - added `quote` discriminator mapping keys to the `items/items/` response property for the response status `200` - **2026-09-23** `99d14bcbd234` — 1 info - added the required property `items/items/oneOf[#/components/schemas/ActivityCopyStartItem]/amount` to the response with the `200` status - **2026-09-18** `280c198d7e84` — 1 info - added the optional property `items/items/oneOf[#/components/schemas/ActivityMoveItem]/move/twap` to the response with the `200` status - …earlier changes not shown [Full history](https://skmtc.dev/legend/apis/legend-api/changes/v1/positions/activity/get.md) --- [API](https://skmtc.dev/legend/apis/legend-api.md) · [All operations](https://skmtc.dev/legend/apis/legend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/legend/apis/legend-api/revisions/cc5ceda89fac?raw)