---
title: "Get a duel by ID"
method: GET
path: "/v1/arena/duels/{duelId}"
tags: ["arena"]
---

# Get a duel by ID

`GET /v1/arena/duels/{duelId}`

## Path parameters

- `duelId` string, required

## Response `200`

Successful response

- ArenaGetDuelByIdOutput, nullable
  - `id` integer, required
  - `status` string, required
  - `team_a_id` integer, required
  - `team_b_id` integer, required
  - `winner_team_id` integer, nullable, required
  - `chain_duel_id` integer, nullable, required
  - `bet` integer, required
  - `duel_time` integer, required
  - `network` 'hyperliquid_testnet' | 'hyperliquid_mainnet' | 'hyperliquid_paper', required
  - `team_a_roi` number, nullable, required
  - `team_b_roi` number, nullable, required
  - `acceptance_expires_at` string, nullable, required
  - `trading_starts_at` string, nullable, required
  - `trading_ends_at` string, nullable, required
  - `created_at` string, required
  - `updated_at` string, required
  - `team_a` ArenaTeam, required
    - `id` integer, required
    - `team_type` string, required
    - `status` string, required
    - `max_bet` integer, required
    - `session_budget` integer, required
    - `duel_time` integer, required
    - `chain_team_id` integer, nullable, required
    - `created_at` string, required
    - `updated_at` string, required
    - `members` ArenaTeamMember[], required
      - `id` string, required
      - `telegram_id` string, nullable, required
      - `username` string, required
      - `display_name` string, required
      - `referral_code` string, nullable, required
      - `referral_code_alt` string, nullable, required
      - `referred_by_id` string, nullable, required
      - `wallet_address` string, nullable, required
      - `created_at` string, required
      - `updated_at` string, required
      - `x_username` string, nullable, required
      - `last_online` string, nullable, required
      - `last_online_mobile` string, nullable, required
      - `avatar_url` string, required
      - `bio` string, 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
      - `rank` integer, nullable, required
      - `rank_testnet` integer, nullable, required
      - `streak` integer, nullable, required
      - `elo` integer, nullable, required
      - `is_npc` boolean, required
      - `last_reset_at` string, nullable, required
      - `feature_image` string, required
      - `completed_onboarding` boolean, required
      - `dismissed_trade_note_cta` boolean, required
      - `has_deposited` boolean, required
      - `invite_code_id` string, nullable, required
      - `main_signer_quorum_id` string, nullable, required
      - `builder_fee_override` integer, nullable, required
      - `fee_rebate_rate` number, nullable, required
      - `deleted_at` string, nullable, required
      - `network_mode` 'hyperliquid_testnet' | 'hyperliquid_mainnet' | 'hyperliquid_paper', required
      - `restrict_dms_to_following` boolean, required
      - `pnl_share_enabled` boolean, required
      - `pnl_share_rate` number, required
      - `acknowledged_season_zero` boolean, required
      - `notification_preferences` unknown, required
      - `fat_finger_settings` unknown, required
      - `account_value_tier` integer, required
      - `is_official` boolean, required
      - `trader_level_seen` integer, nullable, required
      - `max_market_order_slippage` number, nullable, required
      - `wallets` Wallet[]
        - `id` string, required
        - `user_id` string, required
        - `address` string, required
        - `type` 'primary' | 'arena' | 'copy_trading', required
        - `privy_wallet_id` string, required
        - `signer_quorum_id` string, nullable, required
        - `hl_setup_complete` boolean, required
        - `created_at` string, required
        - `updated_at` string, required
      - `stats` UserStats, required
        - `wins` integer, required
        - `losses` integer, required
        - `elo` number, required
        - `followers` integer
        - `following` integer
        - `copying` integer
        - `copiers` integer
        - `matches` integer
        - `streak` integer
        - `totalVolume` number
        - `weeklyVolume` number
        - `totalPnl` number
        - `weeklyPnl` number
        - `monthlyPnl` number
        - `accountValue` number
        - `realizedPnl` number
        - `unrealizedPnl` number
        - `winRate` number
        - `tradeWinRate` number, nullable
        - `totalTrades` integer
        - `avgWinPercent` number, nullable
        - `avgHoldTime` number, nullable
        - `sharpeRatio` number, nullable
        - `fundedAccount` FundedCredential
          - `tier` integer, required
          - `totalPaidOut` integer, required
          - `payoutCount` integer, required
          - `fundedSince` string, required
          - `earningsHidden` boolean, required
        - `tradingClass` 'assassin' | 'guardian' | 'mage' | 'strategist', nullable
        - `xp` number
      - `arena_wallet_address` string, required
  - `team_b` ArenaTeam, required
    - `id` integer, required
    - `team_type` string, required
    - `status` string, required
    - `max_bet` integer, required
    - `session_budget` integer, required
    - `duel_time` integer, required
    - `chain_team_id` integer, nullable, required
    - `created_at` string, required
    - `updated_at` string, required
    - `members` ArenaTeamMember[], required
      - `id` string, required
      - `telegram_id` string, nullable, required
      - `username` string, required
      - `display_name` string, required
      - `referral_code` string, nullable, required
      - `referral_code_alt` string, nullable, required
      - `referred_by_id` string, nullable, required
      - `wallet_address` string, nullable, required
      - `created_at` string, required
      - `updated_at` string, required
      - `x_username` string, nullable, required
      - `last_online` string, nullable, required
      - `last_online_mobile` string, nullable, required
      - `avatar_url` string, required
      - `bio` string, 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
      - `rank` integer, nullable, required
      - `rank_testnet` integer, nullable, required
      - `streak` integer, nullable, required
      - `elo` integer, nullable, required
      - `is_npc` boolean, required
      - `last_reset_at` string, nullable, required
      - `feature_image` string, required
      - `completed_onboarding` boolean, required
      - `dismissed_trade_note_cta` boolean, required
      - `has_deposited` boolean, required
      - `invite_code_id` string, nullable, required
      - `main_signer_quorum_id` string, nullable, required
      - `builder_fee_override` integer, nullable, required
      - `fee_rebate_rate` number, nullable, required
      - `deleted_at` string, nullable, required
      - `network_mode` 'hyperliquid_testnet' | 'hyperliquid_mainnet' | 'hyperliquid_paper', required
      - `restrict_dms_to_following` boolean, required
      - `pnl_share_enabled` boolean, required
      - `pnl_share_rate` number, required
      - `acknowledged_season_zero` boolean, required
      - `notification_preferences` unknown, required
      - `fat_finger_settings` unknown, required
      - `account_value_tier` integer, required
      - `is_official` boolean, required
      - `trader_level_seen` integer, nullable, required
      - `max_market_order_slippage` number, nullable, required
      - `wallets` Wallet[]
        - `id` string, required
        - `user_id` string, required
        - `address` string, required
        - `type` 'primary' | 'arena' | 'copy_trading', required
        - `privy_wallet_id` string, required
        - `signer_quorum_id` string, nullable, required
        - `hl_setup_complete` boolean, required
        - `created_at` string, required
        - `updated_at` string, required
      - `stats` UserStats, required
        - `wins` integer, required
        - `losses` integer, required
        - `elo` number, required
        - `followers` integer
        - `following` integer
        - `copying` integer
        - `copiers` integer
        - `matches` integer
        - `streak` integer
        - `totalVolume` number
        - `weeklyVolume` number
        - `totalPnl` number
        - `weeklyPnl` number
        - `monthlyPnl` number
        - `accountValue` number
        - `realizedPnl` number
        - `unrealizedPnl` number
        - `winRate` number
        - `tradeWinRate` number, nullable
        - `totalTrades` integer
        - `avgWinPercent` number, nullable
        - `avgHoldTime` number, nullable
        - `sharpeRatio` number, nullable
        - `fundedAccount` FundedCredential
          - `tier` integer, required
          - `totalPaidOut` integer, required
          - `payoutCount` integer, required
          - `fundedSince` string, required
          - `earningsHidden` boolean, required
        - `tradingClass` 'assassin' | 'guardian' | 'mage' | 'strategist', nullable
        - `xp` number
      - `arena_wallet_address` string, required
  - `chatRoom` ChatRoom, required
    - `id` string, required
    - `type` 'dm' | 'group' | 'swap' | 'duel' | 'clan' | 'post', required
    - `typeId` string, nullable, required
    - `typeName` string, nullable, required
    - `visibility` 'public' | 'private', required
    - `name` string, nullable, required
    - `imageUrl` string, nullable, required
    - `channelName` string, required
    - `createdAt` string, required
    - `unreadCount` integer, required
    - `lastReadAt` string, required
    - `lastReadMessageId` string, nullable
    - `muted` boolean, required
    - `isPinned` boolean
    - `pinnedAt` string, nullable
    - `isArchived` boolean
    - `archivedAt` string, nullable
    - `status` 'accepted' | 'pending' | 'declined'
    - `myRole` 'owner' | 'admin' | 'member'
    - `isBanned` boolean
    - `otherMembers` ChatRoomMember[], required
      - `user` PublicUser, required
        - `id` string, required
        - `telegram_id` string, nullable, required
        - `username` string, required
        - `display_name` string, required
        - `referral_code` string, nullable, required
        - `referral_code_alt` string, nullable, required
        - `referred_by_id` string, nullable, required
        - `wallet_address` string, nullable, required
        - `created_at` string, required
        - `updated_at` string, required
        - `x_username` string, nullable, required
        - `last_online` string, nullable, required
        - `last_online_mobile` string, nullable, required
        - `avatar_url` string, required
        - `bio` string, 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
        - `rank` integer, nullable, required
        - `rank_testnet` integer, nullable, required
        - `streak` integer, nullable, required
        - `elo` integer, nullable, required
        - `is_npc` boolean, required
        - `last_reset_at` string, nullable, required
        - `feature_image` string, required
        - `completed_onboarding` boolean, required
        - `dismissed_trade_note_cta` boolean, required
        - `has_deposited` boolean, required
        - `invite_code_id` string, nullable, required
        - `main_signer_quorum_id` string, nullable, required
        - `builder_fee_override` integer, nullable, required
        - `fee_rebate_rate` number, nullable, required
        - `deleted_at` string, nullable, required
        - `network_mode` 'hyperliquid_testnet' | 'hyperliquid_mainnet' | 'hyperliquid_paper', required
        - `restrict_dms_to_following` boolean, required
        - `pnl_share_enabled` boolean, required
        - `pnl_share_rate` number, required
        - `acknowledged_season_zero` boolean, required
        - `notification_preferences` unknown, required
        - `fat_finger_settings` unknown, required
        - `account_value_tier` integer, required
        - `is_official` boolean, required
        - `trader_level_seen` integer, nullable, required
        - `max_market_order_slippage` number, nullable, required
        - `wallets` Wallet[]
          - `id` string, required
          - `user_id` string, required
          - `address` string, required
          - `type` 'primary' | 'arena' | 'copy_trading', required
          - `privy_wallet_id` string, required
          - `signer_quorum_id` string, nullable, required
          - `hl_setup_complete` boolean, required
          - `created_at` string, required
          - `updated_at` string, required
      - `role` 'owner' | 'admin' | 'member', required
    - `memberCount` integer
    - `lastMessage` object, nullable, required
      - `id` string, required
      - `content` string, nullable, required
      - `type` 'text' | 'audio' | 'system'
      - `system_payload` unknown
      - `created_at` string, required
      - `user_id` string, required
      - `username` string, required
      - `display_name` string
      - `attachments` object[], required
        - `id` string, required
        - `type` 'image' | 'video' | 'file' | 'audio' | 'gif' | 'sticker', required
        - `url` string, nullable, required
        - `thumbnail_url` string, nullable, required
        - `filename` string, required
      - `deleted_at` string, nullable
      - `edited_at` string, nullable
      - `mentioned_users` PublicUser[]
        - `id` string, required
        - `telegram_id` string, nullable, required
        - `username` string, required
        - `display_name` string, required
        - `referral_code` string, nullable, required
        - `referral_code_alt` string, nullable, required
        - `referred_by_id` string, nullable, required
        - `wallet_address` string, nullable, required
        - `created_at` string, required
        - `updated_at` string, required
        - `x_username` string, nullable, required
        - `last_online` string, nullable, required
        - `last_online_mobile` string, nullable, required
        - `avatar_url` string, required
        - `bio` string, 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
        - `rank` integer, nullable, required
        - `rank_testnet` integer, nullable, required
        - `streak` integer, nullable, required
        - `elo` integer, nullable, required
        - `is_npc` boolean, required
        - `last_reset_at` string, nullable, required
        - `feature_image` string, required
        - `completed_onboarding` boolean, required
        - `dismissed_trade_note_cta` boolean, required
        - `has_deposited` boolean, required
        - `invite_code_id` string, nullable, required
        - `main_signer_quorum_id` string, nullable, required
        - `builder_fee_override` integer, nullable, required
        - `fee_rebate_rate` number, nullable, required
        - `deleted_at` string, nullable, required
        - `network_mode` 'hyperliquid_testnet' | 'hyperliquid_mainnet' | 'hyperliquid_paper', required
        - `restrict_dms_to_following` boolean, required
        - `pnl_share_enabled` boolean, required
        - `pnl_share_rate` number, required
        - `acknowledged_season_zero` boolean, required
        - `notification_preferences` unknown, required
        - `fat_finger_settings` unknown, required
        - `account_value_tier` integer, required
        - `is_official` boolean, required
        - `trader_level_seen` integer, nullable, required
        - `max_market_order_slippage` number, nullable, required
        - `wallets` Wallet[]
          - `id` string, required
          - `user_id` string, required
          - `address` string, required
          - `type` 'primary' | 'arena' | 'copy_trading', required
          - `privy_wallet_id` string, required
          - `signer_quorum_id` string, nullable, required
          - `hl_setup_complete` boolean, required
          - `created_at` string, required
          - `updated_at` string, required
    - `recentMessages` object[]
      - `id` string, required
      - `content` string, nullable, required
      - `type` 'text' | 'audio' | 'system'
      - `system_payload` unknown
      - `created_at` string, required
      - `user_id` string, required
      - `username` string, required
      - `display_name` string
      - `attachments` object[], required
        - `id` string, required
        - `type` 'image' | 'video' | 'file' | 'audio' | 'gif' | 'sticker', required
        - `url` string, nullable, required
        - `thumbnail_url` string, nullable, required
        - `filename` string, required
      - `deleted_at` string, nullable
      - `edited_at` string, nullable
      - `mentioned_users` PublicUser[]
        - `id` string, required
        - `telegram_id` string, nullable, required
        - `username` string, required
        - `display_name` string, required
        - `referral_code` string, nullable, required
        - `referral_code_alt` string, nullable, required
        - `referred_by_id` string, nullable, required
        - `wallet_address` string, nullable, required
        - `created_at` string, required
        - `updated_at` string, required
        - `x_username` string, nullable, required
        - `last_online` string, nullable, required
        - `last_online_mobile` string, nullable, required
        - `avatar_url` string, required
        - `bio` string, 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
        - `rank` integer, nullable, required
        - `rank_testnet` integer, nullable, required
        - `streak` integer, nullable, required
        - `elo` integer, nullable, required
        - `is_npc` boolean, required
        - `last_reset_at` string, nullable, required
        - `feature_image` string, required
        - `completed_onboarding` boolean, required
        - `dismissed_trade_note_cta` boolean, required
        - `has_deposited` boolean, required
        - `invite_code_id` string, nullable, required
        - `main_signer_quorum_id` string, nullable, required
        - `builder_fee_override` integer, nullable, required
        - `fee_rebate_rate` number, nullable, required
        - `deleted_at` string, nullable, required
        - `network_mode` 'hyperliquid_testnet' | 'hyperliquid_mainnet' | 'hyperliquid_paper', required
        - `restrict_dms_to_following` boolean, required
        - `pnl_share_enabled` boolean, required
        - `pnl_share_rate` number, required
        - `acknowledged_season_zero` boolean, required
        - `notification_preferences` unknown, required
        - `fat_finger_settings` unknown, required
        - `account_value_tier` integer, required
        - `is_official` boolean, required
        - `trader_level_seen` integer, nullable, required
        - `max_market_order_slippage` number, nullable, required
        - `wallets` Wallet[]
          - `id` string, required
          - `user_id` string, required
          - `address` string, required
          - `type` 'primary' | 'arena' | 'copy_trading', required
          - `privy_wallet_id` string, required
          - `signer_quorum_id` string, nullable, required
          - `hl_setup_complete` boolean, required
          - `created_at` string, required
          - `updated_at` string, required
  - `currentUserId` string, required

## Other responses

- `400` — Invalid input data
- `401` — Authorization not provided
- `403` — Insufficient access
- `404` — Resource not found
- `500` — Internal server error

---

[API](https://skmtc.net/legend/apis/legend-api.md) · [All operations](https://skmtc.net/legend/apis/legend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/legend/legend-api/revisions/d9a714c3ff23/schema)