"use strict";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];const exMarginPositionsEventsUnsubscribe={"method":`positionsAccountMargin_unsubscribe`,"params":[],"id":1};const exMarginPositionsEventsUpdate={"method":`positionsAccountMargin_update`,"params":[1,{"id":184,"market":`BTC_USDT`,"ctime":1737731271.306934,"mtime":1737731271.306934,"amount":`-0.094048`,"amount_in_money":`9939.79769088`,"base_price":`105688.56`,"pnl":`-1157.88`,"liq_price":`126462.54`,"liq_stage":`margin_call`,"unrealized_funding":`0.0231431327519745`,"funding":`0`,"margin":`1109.77`,"free_margin":`-652.9`,"realized_pnl":`-8.945817921792`,"position_side":`LONG`}],"id":null};const exMarginPositionsEventsSubscribeResponse={"error":null,"result":{"status":`success`},"id":1};const exMarginPositionsEventsSubscribe={"method":`positionsAccountMargin_subscribe`,"params":[],"id":1};const marginPositionsEventsUpdate=[{name:`id`,type:`null`,required:true,description:`Update events have null id`},{name:`method`,type:`string`,required:true,description:"Method name. Fixed value: `positionsAccountMargin_update`."},{name:`params`,type:`array`,required:true,description:`Event tuple: - [0] Event type (1=Margin call, 2=Liquidation) - [1] Position object with all position details`}];const WsSubscribeSteps=({subscribe,confirmation,update,unsubscribe,subscribeNote,updateNote,updateExtra})=>{const _components={div:`div`,p:`p`,span:`span`,..._provideComponents()};const[isDark,setIsDark]=useState(typeof document!==`undefined`?document.documentElement.classList.contains(`dark`):true);useEffect(()=>{const check=()=>setIsDark(document.documentElement.classList.contains(`dark`));check();const observer=new MutationObserver(check);observer.observe(document.documentElement,{attributes:true,attributeFilter:[`class`]});return()=>observer.disconnect()},[]);const TOKEN_COLORS=isDark?{key:`#79c0ff`,string:`#a5d6ff`,number:`#e3b341`,boolean:`#ff7b72`,null:`#8b949e`,punctuation:`#c9d1d9`,ws:`#c9d1d9`}:{key:`#0550ae`,string:`#0a3069`,number:`#953800`,boolean:`#cf222e`,null:`#6e7781`,punctuation:`#24292f`,ws:`#24292f`};const tokenize=json=>{const tokens=[];let i=0;while(i{const json=JSON.stringify(data,null,2);const tokens=tokenize(json);return _jsxs(_components.div,{className:`mint-border mint-border-gray-200 dark:mint-border-[#30363d]`,style:{borderRadius:`0.5rem`,overflow:`hidden`,marginBottom:`0.75rem`},children:[_jsx(_components.div,{className:`mint-bg-gray-50 dark:mint-bg-[#161b22] mint-border-b mint-border-gray-200 dark:mint-border-[#30363d] mint-text-gray-500 dark:mint-text-[#8b949e]`,style:{padding:`0.25rem 1rem`,fontSize:`0.7rem`,fontFamily:`ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace`},children:`json`}),_jsx(_components.div,{className:`mint-bg-white dark:mint-bg-[#0d1117]`,style:{margin:0,padding:`0.875rem 1.125rem`,overflowX:`auto`,fontSize:`0.8125rem`,lineHeight:`1.65`,fontFamily:`ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace`,whiteSpace:`pre`},children:tokens.map((t,idx)=>_jsx(_components.span,{style:{color:TOKEN_COLORS[t.type]},children:t.value},idx))})]})};const CIRCLE=32;const WsStep=({number,title,isLast,children})=>_jsxs(_components.div,{style:{display:`flex`,gap:`1rem`},children:[_jsxs(_components.div,{style:{display:`flex`,flexDirection:`column`,alignItems:`center`,flexShrink:0,width:CIRCLE},children:[_jsx(_components.div,{className:`mint-bg-gray-100 dark:mint-bg-gray-700 mint-border-gray-300 dark:mint-border-gray-600 mint-text-gray-900 dark:mint-text-gray-100`,style:{width:CIRCLE,height:CIRCLE,borderRadius:`50%`,border:`1.5px solid`,display:`flex`,alignItems:`center`,justifyContent:`center`,fontSize:`0.8125rem`,fontWeight:600,flexShrink:0},children:number}),!isLast&&_jsx(_components.div,{className:`mint-bg-gray-200 dark:mint-bg-gray-700`,style:{width:2,flex:1,minHeight:`1.5rem`}})]}),_jsxs(_components.div,{style:{flex:1,paddingBottom:isLast?`0.5rem`:`1.75rem`,paddingTop:`4px`,minWidth:0},children:[_jsx(_components.p,{style:{fontWeight:600,fontSize:`1rem`,margin:`0 0 0.75rem 0`,lineHeight:`${CIRCLE}px`},children:title}),children]})]});return _jsxs(_components.div,{style:{margin:`1.25rem 0`},children:[_jsxs(WsStep,{number:1,title:`Send subscription request`,children:[subscribeNote&&_jsx(_components.p,{style:{margin:`0 0 0.75rem 0`},children:subscribeNote}),_jsx(JsonBlock,{data:subscribe})]}),_jsx(WsStep,{number:2,title:`Receive confirmation`,children:_jsx(JsonBlock,{data:confirmation})}),_jsxs(WsStep,{number:3,title:`Receive real-time updates`,children:[updateNote&&_jsx(_components.p,{style:{margin:`0 0 0.75rem 0`},children:updateNote}),_jsx(JsonBlock,{data:update}),updateExtra]}),_jsx(WsStep,{number:4,title:`Unsubscribe`,isLast:true,children:_jsx(JsonBlock,{data:unsubscribe})})]})};const WsMessageExample=({data,title})=>{const _components={div:`div`,p:`p`,span:`span`,..._provideComponents()};const[isDark,setIsDark]=useState(typeof document!==`undefined`?document.documentElement.classList.contains(`dark`):true);useEffect(()=>{const check=()=>setIsDark(document.documentElement.classList.contains(`dark`));check();const observer=new MutationObserver(check);observer.observe(document.documentElement,{attributes:true,attributeFilter:[`class`]});return()=>observer.disconnect()},[]);const COLORS=isDark?{key:`#79c0ff`,string:`#a5d6ff`,number:`#e3b341`,boolean:`#ff7b72`,null:`#8b949e`,punctuation:`#c9d1d9`,ws:`#c9d1d9`}:{key:`#0550ae`,string:`#0a3069`,number:`#953800`,boolean:`#cf222e`,null:`#6e7781`,punctuation:`#24292f`,ws:`#24292f`};const tokenize=json=>{const tokens=[];let i=0;while(i_jsx(_components.span,{style:{color:COLORS[t.type]},children:t.value},idx))})]})]})};const WsSchemaTable=({title,fields})=>{const _components={div:`div`,span:`span`,..._provideComponents()};const[isDark,setIsDark]=useState(typeof document!==`undefined`?document.documentElement.classList.contains(`dark`):true);useEffect(()=>{const check=()=>setIsDark(document.documentElement.classList.contains(`dark`));check();const observer=new MutationObserver(check);observer.observe(document.documentElement,{attributes:true,attributeFilter:[`class`]});return()=>observer.disconnect()},[]);const T=isDark?{border:`#374151`,borderSubtle:`#1f2937`,headerBg:`#1f2937`,headerText:`#9ca3af`,titleBg:`#1f2937`,titleText:`#d1d5db`,fieldBg:`#374151`,fieldText:`#e5e7eb`,reqYes:`#f3f4f6`,reqNo:`#4b5563`,descText:`#9ca3af`,emptyText:`#4b5563`,enumBg:`rgb(120 53 15 / 0.3)`,enumText:`#fbbf24`}:{border:`#e5e7eb`,borderSubtle:`#f3f4f6`,headerBg:`#f9fafb`,headerText:`#6b7280`,titleBg:`#f9fafb`,titleText:`#374151`,fieldBg:`#f3f4f6`,fieldText:`#1f2937`,reqYes:`#111827`,reqNo:`#d1d5db`,descText:`#6b7280`,emptyText:`#d1d5db`,enumBg:`#fffbeb`,enumText:`#92400e`};const TYPE_STYLE=isDark?{string:{backgroundColor:`rgb(88 28 135 / 0.25)`,color:`#c084fc`},integer:{backgroundColor:`rgb(154 52 18 / 0.25)`,color:`#fb923c`},number:{backgroundColor:`rgb(154 52 18 / 0.25)`,color:`#fb923c`},boolean:{backgroundColor:`rgb(30 64 175 / 0.25)`,color:`#60a5fa`},array:{backgroundColor:`rgb(17 94 89 / 0.25)`,color:`#2dd4bf`},object:{backgroundColor:`rgb(55 65 81 / 0.4)`,color:`#9ca3af`},null:{backgroundColor:`rgb(55 65 81 / 0.4)`,color:`#9ca3af`}}:{string:{backgroundColor:`#faf5ff`,color:`#6b21a8`},integer:{backgroundColor:`#fff7ed`,color:`#9a3412`},number:{backgroundColor:`#fff7ed`,color:`#9a3412`},boolean:{backgroundColor:`#eff6ff`,color:`#1e40af`},array:{backgroundColor:`#f0fdfa`,color:`#115e59`},object:{backgroundColor:`#f3f4f6`,color:`#374151`},null:{backgroundColor:`#f3f4f6`,color:`#374151`}};const MONO=`ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace`;const HEADER={padding:`0.5rem 1rem`,fontSize:`0.6875rem`,fontWeight:600,textTransform:`uppercase`,letterSpacing:`0.05em`,whiteSpace:`nowrap`,color:T.headerText,backgroundColor:T.headerBg,borderBottom:`1px solid ${T.border}`};const CELL={padding:`0.625rem 1rem`,fontSize:`0.8125rem`,display:`flex`,alignItems:`center`,minWidth:0};const hasRequired=fields.some(f=>f.required===true);const hasEnum=fields.some(f=>f.enum&&f.enum.length>0);const gridTemplateColumns=[`minmax(120px, auto)`,`minmax(70px, auto)`,...hasRequired?[`minmax(70px, auto)`]:[],...hasEnum?[`minmax(120px, auto)`]:[],`1fr`].join(` `);return _jsxs(_components.div,{style:{margin:`1.25rem 0`,borderRadius:`0.5rem`,border:`1px solid ${T.border}`,overflow:`hidden`,fontSize:`0.8125rem`},children:[title&&_jsx(_components.div,{style:{padding:`0.5rem 1rem`,fontSize:`0.75rem`,fontWeight:600,letterSpacing:`0.02em`,backgroundColor:T.titleBg,borderBottom:`1px solid ${T.border}`,color:T.titleText},children:title}),_jsxs(_components.div,{style:{display:`grid`,gridTemplateColumns,width:`100%`,overflowX:`auto`},children:[_jsx(_components.div,{style:HEADER,children:`Field`}),_jsx(_components.div,{style:HEADER,children:`Type`}),hasRequired&&_jsx(_components.div,{style:HEADER,children:`Required`}),hasEnum&&_jsx(_components.div,{style:HEADER,children:`Values`}),_jsx(_components.div,{style:HEADER,children:`Description`}),fields.map((f,i)=>{const borderTop=`1px solid ${i===0?T.border:T.borderSubtle}`;const typeStyle=TYPE_STYLE[f.type]||TYPE_STYLE.object;return[_jsx(_components.div,{style:{...CELL,whiteSpace:`nowrap`,borderTop},children:_jsx(_components.span,{style:{padding:`0.125rem 0.375rem`,borderRadius:`0.25rem`,fontSize:`0.75rem`,fontFamily:MONO,backgroundColor:T.fieldBg,color:T.fieldText},children:f.name})},`${i}-n`),_jsx(_components.div,{style:{...CELL,whiteSpace:`nowrap`,borderTop},children:_jsx(_components.span,{style:{padding:`0.125rem 0.375rem`,borderRadius:`0.25rem`,fontSize:`0.75rem`,whiteSpace:`nowrap`,fontFamily:MONO,...typeStyle},children:f.type})},`${i}-t`),...hasRequired?[_jsx(_components.div,{style:{...CELL,borderTop,fontWeight:f.required?500:400,color:f.required?T.reqYes:T.reqNo},children:f.required?`Yes`:`—`},`${i}-r`)]:[],...hasEnum?[_jsx(_components.div,{style:{...CELL,borderTop,flexWrap:`wrap`,gap:`0.25rem`},children:f.enum&&f.enum.length>0?f.enum.map((v,j)=>_jsx(_components.span,{style:{padding:`0.125rem 0.375rem`,borderRadius:`0.25rem`,fontSize:`0.75rem`,whiteSpace:`nowrap`,fontFamily:MONO,backgroundColor:T.enumBg,color:T.enumText},children:String(v)},j)):_jsx(_components.span,{style:{color:T.emptyText},children:`—`})},`${i}-e`)]:[],_jsx(_components.div,{style:{...CELL,borderTop,color:T.descText},children:f.description},`${i}-d`)]})]})]})};const WsChannelOverview=({operations})=>{const _components={code:`code`,div:`div`,span:`span`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents()};const hasPush=operations.some(op=>op.push);const Th=({children})=>_jsx(_components.th,{className:`mint-text-left mint-text-gray-500 dark:mint-text-gray-400 mint-border-b mint-border-gray-200 dark:mint-border-gray-700`,style:{padding:`0.5rem 1rem`,fontSize:`0.6875rem`,fontWeight:600,textTransform:`uppercase`,letterSpacing:`0.05em`,whiteSpace:`nowrap`},children});const PushBadge=({value})=>{const dashIdx=value.indexOf(` — `);const method=dashIdx!==-1?value.slice(0,dashIdx):value;const desc=dashIdx!==-1?value.slice(dashIdx+3):null;return _jsxs(_components.span,{style:{display:`inline-flex`,alignItems:`center`,gap:`0.375rem`,flexWrap:`wrap`},children:[_jsx(_components.code,{className:`mint-bg-blue-50 dark:mint-bg-blue-900/20 mint-text-blue-800 dark:mint-text-blue-400`,style:{padding:`0.125rem 0.375rem`,borderRadius:`0.25rem`,fontSize:`0.75rem`,whiteSpace:`nowrap`},children:method}),desc&&_jsxs(_components.span,{className:`mint-text-gray-500 dark:mint-text-gray-400`,style:{fontSize:`0.75rem`},children:[`— `,desc]})]})};return _jsx(_components.div,{style:{margin:`1.25rem 0`,borderRadius:`0.5rem`,border:`1px solid`,overflow:`hidden`,fontSize:`0.8125rem`},className:`mint-border-gray-200 dark:mint-border-gray-700`,children:_jsxs(_components.table,{className:`mint-w-full`,style:{margin:0,borderCollapse:`collapse`,tableLayout:`auto`},children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{className:`mint-bg-gray-50 dark:mint-bg-gray-800/60 mint-border-b mint-border-gray-200 dark:mint-border-gray-700`,children:[Th({children:`Operation`}),Th({children:_jsxs(_components.span,{children:[_jsx(_components.span,{style:{color:`#16a34a`},children:`→`}),` You send`]})}),Th({children:`← Server responds`}),hasPush&&Th({children:_jsxs(_components.span,{children:[_jsx(_components.span,{style:{color:`#2563eb`},children:`⟵`}),` Server pushes`]})})]})}),_jsx(_components.tbody,{children:operations.map((op,i)=>_jsxs(_components.tr,{className:`mint-border-b mint-border-gray-100 dark:mint-border-gray-800`,style:{borderBottom:i===operations.length-1?`none`:undefined},children:[_jsx(_components.td,{className:`mint-text-gray-900 dark:mint-text-gray-100`,style:{padding:`0.625rem 1rem`,fontWeight:500,whiteSpace:`nowrap`},children:op.name}),_jsx(_components.td,{style:{padding:`0.625rem 1rem`,whiteSpace:`nowrap`},children:_jsx(_components.code,{className:`mint-bg-green-50 dark:mint-bg-green-900/20 mint-text-green-800 dark:mint-text-green-400`,style:{padding:`0.125rem 0.375rem`,borderRadius:`0.25rem`,fontSize:`0.75rem`},children:op.send})}),_jsx(_components.td,{className:`mint-text-gray-500 dark:mint-text-gray-400`,style:{padding:`0.625rem 1rem`},children:op.receive}),hasPush&&_jsx(_components.td,{style:{padding:`0.625rem 1rem`},children:op.push?PushBadge({value:op.push}):_jsx(_components.span,{className:`mint-text-gray-300 dark:mint-text-gray-600`,children:`—`})})]},i))})]})})};function _createMdxContent(props){const _components={a:`a`,code:`code`,div:`div`,p:`p`,..._provideComponents(),...props.components},{Heading,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Warning,{children:_jsxs(_components.p,{children:[`This is a private channel. `,_jsx(_components.a,{href:`/websocket/authentication`,children:`Authorize`}),` the WebSocket connection before subscribing.`]})}),` `,_jsx(_components.p,{children:`Subscribe to margin call and liquidation event notifications for collateral positions. Events fire when a position enters margin call or liquidation state.`}),` `,_jsx(WsChannelOverview,{operations:[{name:`Subscribe`,send:`positionsAccountMargin_subscribe`,receive:`Confirmation (status: success)`,push:`positionsAccountMargin_update — margin call or liquidation event`},{name:`Unsubscribe`,send:`positionsAccountMargin_unsubscribe`,receive:`Confirmation (status: success)`,push:null}]}),` `,_jsx(Heading,{level:`2`,id:`subscribe-to-position-events`,children:`Subscribe to position events`}),` `,_jsx(WsSubscribeSteps,{subscribe:exMarginPositionsEventsSubscribe,subscribeNote:`params is always an empty array.`,confirmation:exMarginPositionsEventsSubscribeResponse,update:exMarginPositionsEventsUpdate,updateNote:`params[0] is the event type. params[1] is the position object.`,updateExtra:_jsxs(_components.div,{children:[_jsxs(_components.div,{style:{width:`100%`,fontSize:`0.875rem`,marginBottom:`1rem`},children:[_jsxs(_components.div,{style:{display:`flex`,borderBottom:`1px solid #e5e7eb`,fontWeight:600},children:[_jsx(_components.div,{style:{padding:`8px 12px`,flex:`0 0 80px`},children:`Value`}),_jsx(_components.div,{style:{padding:`8px 12px`,flex:1},children:`Event`})]}),_jsxs(_components.div,{style:{display:`flex`,borderBottom:`1px solid #f3f4f6`},children:[_jsx(_components.div,{style:{padding:`8px 12px`,flex:`0 0 80px`},children:_jsx(_components.code,{children:`1`})}),_jsx(_components.div,{style:{padding:`8px 12px`,flex:1},children:`Margin call`})]}),_jsxs(_components.div,{style:{display:`flex`},children:[_jsx(_components.div,{style:{padding:`8px 12px`,flex:`0 0 80px`},children:_jsx(_components.code,{children:`2`})}),_jsx(_components.div,{style:{padding:`8px 12px`,flex:1},children:`Liquidation`})]})]}),_jsxs(_components.div,{style:{borderLeft:`3px solid #60a5fa`,paddingLeft:`0.75rem`,marginTop:`0.75rem`,fontSize:`0.8125rem`,color:`#374151`,lineHeight:`1.5`},children:[_jsx(_components.code,{children:`liq_stage`}),` values: `,_jsx(_components.code,{children:`margin_call`}),`, `,_jsx(_components.code,{children:`liquidation`}),`, or `,_jsx(_components.code,{children:`null`}),` (healthy).`]})]}),unsubscribe:exMarginPositionsEventsUnsubscribe}),` `,_jsx(Heading,{level:`2`,id:`position-event-object`,children:`Position event object`}),` `,_jsx(WsSchemaTable,{fields:marginPositionsEventsUpdate})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{exMarginPositionsEventsUnsubscribe,exMarginPositionsEventsUpdate,exMarginPositionsEventsSubscribeResponse,exMarginPositionsEventsSubscribe,marginPositionsEventsUpdate,WsSubscribeSteps,WsMessageExample,WsSchemaTable,WsChannelOverview,default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+" `"+id+"` to be defined: you likely forgot to import, pass, or provide it.")}

​Subscribe to position events

​Position event object

Subscribe to position events

Position event object