[{"_1":2,"_174":-5,"_175":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_153":154},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":17},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":85,"_106":107,"_144":-5,"_145":11,"_146":17,"_147":11,"_148":-5,"_149":11,"_150":-5,"_151":152},"canonicalUrl","https://hub.docker.com/r/dydxprotocol/liquidator/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","dydxprotocol","reponame","liquidator","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2019-05-16T21:18:49.132908Z","description","","is_private","last_updated","2020-07-14T22:17:35.659487Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",19772,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","

\n\n

\n \n

\n \n \n

\n \n \n License

\n \n \n

\n \n

\n\n# dYdX Liquidator\n\nBot to automatically liquidate undercollateralized and expired dYdX accounts.\n\n## Usage\n\n### Docker\n\nRequires a running [docker](https://docker.com) engine.\n\n```\ndocker run \\\n -e WALLET_ADDRESS=0x2c7536E3605D9C16a7a3D7b1898e529396a65c23 \\\n -e WALLET_PRIVATE_KEY=0x4c0883a69102937d6231471b5dbb6204fe5129617082792ae468d01a3f362318 \\\n -e ETHEREUM_NODE_URL=https://mainnet.infura.io/v3/YOUR_INFURA_KEY \\\n -e SOLO_LIQUIDATIONS_ENABLED=true \\\n -e PERP_LIQUIDATIONS_ENABLED=true \\\n -e SOLO_EXPIRATIONS_ENABLED=false \\\n dydxprotocol/liquidator\n```\n\n## Overview\n\nThis service will automatically liquidate undercollateralized and/or expired accounts on dYdX.\n\nThis bot works for Solo (Margin-Trading) and/or Perp (Perpetual Market) accounts. Use the envvars `SOLO_LIQUIDATIONS_ENABLED`, `SOLO_EXPIRATIONS_ENABLED`, `PERP_LIQUIDATIONS_ENABLED` to control what kind of liquidations to perform.\n\n**Liquidations on dYdX happen internally between Accounts, so you will need an already-funded dYdX Account to use this liquidator bot. If you use the default of `SOLO_ACCOUNT_NUMBER=0`, you can fund your dYdX Margin (Solo) or Perpetual (Perp) Account on [trade.dydx.exchange/balances](https://trade.dydx.exchange/balances).**\n\nSuccessfully liquidating Accounts will modify your dYdX Account balances. You can liquidate assets you do not have in your Account provided you have another asset as collateral, which will just cause your dYdX Account Balance to go negative in that asset.\n\n### Solo Liquidations\nLiquidations on Solo reward a 5% spread on top of the current oracle prices for the assets being liquidated and used as collateral. Example:\n\nUndercollateralized Account:\n```\n+2 ETH\n-350 DAI\n```\n\nLiquidator Account:\n```\n+100 ETH\n-1000 DAI\n```\n\nOracle Prices:\n```\nETH Oracle Price: $200\nDAI Oracle Price: $1\n```\n\nFully liquidating this account would cause 350 DAI to be paid to zero out its balance, and would reward `350 DAI * ($1/DAI / $200/ETH) * 1.05 = 1.8375 ETH` as payout. After the liquidation the account balances would be:\n\n\nUndercollateralized Account:\n```\n+0.1625 ETH\n0 DAI\n```\n\nLiquidator Account:\n```\n+101.8375 ETH\n-1350 DAI\n```\n\n### Perp Liquidations\nPerp Liquidations allow the liquidator to fully subsume any account with a collateralization that falls below 107.5%. After the liquidation, 20% of any profits go towards a dYdX insurance fund that prevents deleveraging.\n\nUndercollateralized Account:\n```\n+2.1 Position (BTC)\n-200 Margin (USDC)\n```\n\nLiquidator Account:\n```\n+0 Position (BTC)\n+1000 Margin (USDC)\n```\n\nOracle Prices:\n```\nBTC Oracle Price: 100 USDC per BTC\n```\n\nFully liquidating the undercollateralized account would allow the account to be fully taken over by the Liquidator. Since the \"value\" of the account was `2.1 BTC * (100 USDC/BTC) - 200 USDC = 10 USDC`, 20% of that profit then goes to the insurance pool. After the liquidation the account balances would be:\n\nLiquidated Account:\n```\n+0 Position (BTC)\n+0 Margin (USDC)\n```\n\nLiquidator Account:\n```\n+2.1 Position (BTC)\n+798 Margin (USDC)\n```\n\nInsurance Fund:\n```\n+2 Margin (USDC)\n```\n\n## Configuration\n\n### Environment Variables\n\n|ENV Variable|Description|\n|-|-|\n|WALLET_ADDRESS|**REQUIRED** Ethereum address of the dYdX account owner that will do the liquidations\n|WALLET_PRIVATE_KEY|**REQUIRED** Ethereum private key the dYdX account owner that will do the liquidations. Make sure that \"0x\" is at the start of it (MetaMask exports private keys without it).|\n|NETWORK_ID|Ethereum Network ID|\n|ETHEREUM_NODE_URL|**REQUIRED** The URL of the Ethereum node to use (e.g. an infura url)|\n|LIQUIDATION_KEY_EXPIRATION_SEC|Amount of time in seconds to wait before trying to liquidate the same account again|300|\n|GAS_STATION_URL|URL of the gas station API to use|\n|GAS_PRICE_MULTIPLIER|How much to multiply the `fast` gas price by when sending transactions|\n|GAS_PRICE_UPDATE_FREQUENCY_SEC|How frequently to update the gas price|\n|SOLO_LIQUIDATIONS_ENABLED|true or false - whether to liquidate solo accounts (true by default)|\n|SOLO_EXPIRATIONS_ENABLED|true or false - whether to liquidate expired accounts (false by default)|\n|SOLO_COLLATERAL_PREFERENCES|List of preferences for which collateral markets to receive first when liquidating|\n|SOLO_OWED_PREFERENCES|List of preferences for which markets to liquidate first on an account when liquidating|\n|SOLO_ACCOUNT_NUMBER|The dYdX account number to use for the liquidating account. If you're not sure what this is, use 0. This will show up on [trade.dydx.exchange/account](https://trade.dydx.exchange/account) if you connect with the same wallet.|\n|SOLO_MIN_ACCOUNT_COLLATERALIZATION|The desired minimum collateralization of the liquidator account after completing a liquidation. Prevents the liquidator account from being at risk of being liquidated itself if the price of assets continues to move in some direction. Higher values are safer. e.g. 0.5 = 150% collateralization|\n|SOLO_MIN_OVERHEAD_VALUE|If you can liquidate less than this amount of value before hitting `SOLO_MIN_ACCOUNT_COLLATERALIZATION`, then don't liquidate. (1 USD = 1e36)|\n|SOLO_EXPIRED_ACCOUNT_DELAY_SECONDS|How long to wait before liquidating expired accounts. The spread for liquidating expired accounts ramps up linearly from 0% to 5% over 1 hour.|\n|PERP_LIQUIDATIONS_ENABLED|true or false - whether to liquidate perpetual accounts (false by default)|\n|PERP_MIN_ACCOUNT_COLLATERALIZATION|The desired minimum collateralization of the liquidator account after completing a perpetual liquidation. Higher values are safer. e.g. 0.5 = 150% collateralization|\n|ACCOUNT_POLL_INTERVAL_MS|How frequently to poll for liquidatable accounts|\n|MARKET_POLL_INTERVAL_MS|How frequently to poll for market updates|\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",1346050833,"orgData",{"_86":87,"_88":89,"_90":91,"_92":29,"_93":94,"_95":44,"_96":94,"_97":98,"_99":100,"_101":102,"_103":44,"_104":44,"_105":17},"id","eb5a4e2e95e142e68842e6f610b23246","uuid","eb5a4e2e-95e1-42e6-8842-e6f610b23246","type","organization","orgname","full_name","dYdX","location","company","profile_url","https://dydx.exchange","date_joined","2018-05-14T20:55:01.997619Z","gravatar_url","https://www.gravatar.com/avatar/d266f4fbf4be0908bb80b3aaef2f2f49?s=80&r=g&d=mm","gravatar_email","badge","is_active","recentTags",[108],{"_109":40,"_110":111,"_112":113,"_86":114,"_115":116,"_46":133,"_134":111,"_135":29,"_136":52,"_53":137,"_138":139,"_140":124,"_141":133,"_142":62,"_143":17},"content_type","creator",3123573,"full_size",177721532,56019514,"images",[117],{"_118":119,"_120":121,"_122":44,"_123":124,"_125":126,"_127":128,"_129":44,"_130":-5,"_131":113,"_59":62,"_132":-5},"architecture","amd64","digest","sha256:29512d30d7a037e96b92eb5e43370b57614b77b071f9f58a14d9ed938717b5f8","features","last_pulled","2026-09-27T19:21:40.5120267Z","last_pushed","2020-07-14T22:17:36Z","os","linux","os_features","os_version","size","variant","2020-07-14T22:17:35.254979Z","last_updater","last_updater_username","media_type","latest","repository",7130444,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":155,"_162":163,"_151":172,"_173":11},{"_36":156,"_38":157,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":158,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":159,"_75":11,"_76":161,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":160},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_164":60,"_165":-5,"_166":-5,"_167":168},"count","next","previous","results",[169],{"_109":40,"_110":111,"_112":113,"_86":114,"_115":170,"_46":133,"_134":111,"_135":29,"_136":52,"_53":137,"_138":139,"_140":124,"_141":133,"_142":62,"_143":17},[171],{"_118":119,"_120":121,"_122":44,"_123":124,"_125":126,"_127":128,"_129":44,"_130":-5,"_131":113,"_59":62,"_132":-5},[],"canDeleteTags","actionData","errors"]

dydxprotocol/liquidator

Tags for dydxprotocol/liquidator