Wallets

Deposit Addresses

GET https://api.poloniex.com/wallets/addresses

Get all deposit addresses for a user.

Some currencies use a common deposit address for everyone on the exchange and designate the account for which this payment is destined by populating paymentID field. In these cases, use /currencies to look up the mainAccount for the currency to find the deposit address and use the address returned here as the paymentID. Note: currencies will only include a mainAccount property for currencies which require a paymentID.

Request Parameter	Data Type	Required	Description
currency	String	false	the currency to display for the deposit address. If not specified, the deposit address of all currencies will be displayed.

Response Field	Data Type	Description
currency	String	the deposit address for the currency

Example output:

{
  "AAVE": "0xae8d0d7c520daebb1580dabaa91f3ccf8ae492f5",
  "AMP": "0xae8d0d7c520daebb1580dabaa91f3ccf8ae492f5",
  "ATOM": "cosmos18clcz526q274gdvmjv820f45pua03rhn4xplkz",
  "XLMBEAR": "0xae8d0d7c520daebb1580dabaa91f3ccf8ae492f5",
  "XLMBULL": "0xae8d0d7c520daebb1580dabaa91f3ccf8ae492f5",
  "XYM": "bqz8hDK2mm"
}

Wallets Activity Records

GET https://api.poloniex.com/wallets/activity

Get deposit and withdrawal activity history within a range window for a user

Request Parameter	Data Type	Required	Description
start	Long	true	the start UNIX timestamp of activities
end	Long	true	the end UNIX timestamp of activities
activityType	String	false	The type of activity: deposits and withdrawals. If no activity type is specified, activities of all types will be returned.

Response Field	Data Type	Description
deposits	Json object	list of deposits activities
withdrawals	Json object	list of withdrawals activities

deposits Field	Data Type	Description
depositNumber	Long	the unique deposit ID for this deposit
currency	String	the currency of this deposit
address	String	the address to which this deposit was sent
amount	String	the total value of the deposit (network fees will not be included in this)
confirmations	Integer	the total number of confirmations for this deposit
txid	String	the blockchain transaction ID of this deposit
timestamp	Long	the UNIX timestamp when this deposit was first noticed
status	String	the current status of this deposit (either PENDING or COMPLETED)

withdrawals Field	Data Type	Description
withdrawalRequestsId	Long	the unique ID for this withdrawal
currency	String	the currency of this withdrawal
address	String	the address to which the withdrawal was made
amount	String	the total amount withdrawn including the fee
fee	String	the fee paid to the exchange for this withdrawal
timestamp	Long	the Unix timestamp of the withdrawal
status	String	the status of the withdrawal (one of PROCESSING, AWAITING APPROVAL, COMPLETED or COMPLETE ERROR)
txid	String	the blockchain transaction ID of this withdrawal
ipAddress	String	the IP address which initiated the withdrawal request
paymentID	String	the paymentID specified for this withdrawal. If none were specified, the field will be null

Example output:

{ 
  "deposits":
    [ 
      { 
        "depositNumber": 7397520,
        "currency": "BTC",
        "address": "131rdg5Rzn6BFufnnQaHhVa5ZtRU1J2EZR",
        "amount": "0.06830697",
        "confirmations": 1,
        "txid": "3a4b9b2404f6e6fb556c3e1d46a9752f5e70a93ac1718605c992b80aacd8bd1d",
        "timestamp": 1506005439,
        "status": "COMPLETED"
      }, 
      { 
        "depositNumber": 7397521,
        "currency": "BCH",
        "address": "1FhCkdKeMGa621mCpAtFYzeVfUBnHbooLj",
        "amount": "10.00000000",
        "confirmations": 5,
        "txid": "eb2e0914105b02fbe6e17913d74b4e5950c1ba122eb71afdfc49e2c58b272456",
        "timestamp": 1508436102,
        "status": "COMPLETED"
      },
      { 
        "depositNumber": 7397518,
        "currency": "ETH",
        "address": "0xb7e033598cb94ef5a35349316d3a2e4f95f308da",
        "amount": "29.99825341",
        "confirmations": 53,
        "txid": "f7e7eeb44edcad14c0f90a5fffb1cbb4b80e8f9652124a0838f6906ca939ccd2",
        "timestamp": 1537305507,
        "status": "COMPLETED"
      } 
    ],
  "withdrawals":
    [ 
      { 
        "withdrawalRequestsId": 7397527,
        "currency": "ETC",
        "address": "0x26419a62055af459d2cd69bb7392f5100b75e304",
        "amount": "13.19951600",
        "fee": "0.01000000",
        "timestamp": 1506010932,
        "status": "COMPLETED",
        "txid": "343346392f82ac16e8c2604f2a604b7b2382d0e9d8030f673821f8de4b5f5bk",
        "ipAddress": "1.2.3.4",
        "paymentID": null
      },
      { 
        "withdrawalRequestsId": 7704882,
        "currency": "ETH",
        "address": "0x00c90335F92FfcD26C8c915c79d7aB424454B7c7",
        "amount": "0.01318826",
        "fee": "0.00500000",
        "timestamp": 1507908127,
        "status": "COMPLETED",
        "txid": "423346392f82ac16e8c2604f2a604b7b2382d0e9d8030f673821f8de4b5f5a30",
        "ipAddress": "1.2.3.4",
        "paymentID": null
      }
    ]
}

New Currency Address

POST https://api.poloniex.com/wallets/address

Create a new address for a currency.

Request Parameter	Data Type	Required	Description
currency	String	true	the currency to use for the deposit address

Example request:

{
    "currency": "TRX"
}

Response Field	Data Type	Description
address	String	the newly created address

Example output:

{
    "address": "0xae8d0d7c520daebb1580dabaa91f3ccf8ae492f5"
}

Withdraw Currency

POST https://api.poloniex.com/wallets/withdraw

Immediately places a withdrawal for a given currency, with no email confirmation. In order to use this method, withdrawal privilege must be enabled for your API key.

Some currencies use a common deposit address for everyone on the exchange and designate the account for which this payment is destined by populating paymentID field. In these cases, use /currencies to look up the mainAccount for the currency to find the deposit address and use the address returned by /wallets/addresses or generate one using /wallets/address as the paymentId. Note: currencies will only include a mainAccount property for currencies which require a paymentID.

For currencies where there are multiple networks to choose from (like USDT or BTC), you can specify the chain by setting the "currency" parameter to be a multiChain currency name, like USDTTRON, USDTETH, or BTCTRON. You can get information on these currencies, like fees or if they"re disabled, by adding the "includeMultiChainCurrencies" optional parameter to the /currencies endpoint.

Request Parameter	Data Type	Required	Description
currency	String	true	currency name.
amount	String	true	withdrawal amount.
address	String	true	withdrawal address.
paymentId	String	false	paymentId for currencies that use a command deposit address.
allowBorrow	Boolean	false	allow to transfer borrowed funds (Default: false)

Example request:

{
    "currency": "ETH",
    "amount": "1.50",
    "address": "0xbb8d0d7c346daecc2380dabaa91f3ccf8ae232fb4"
}

Response Field	Data Type	Description
withdrawalRequestsId	Long	the withdrawal reference ID

Example output:

{
    "withdrawalRequestsId": 33485231
}

Withdraw Currency V2

POST https://api.poloniex.com/v2/wallets/withdraw

Immediately places a withdrawal for a given currency, with no email confirmation. In order to use this method, withdrawal privilege must be enabled for your API key.

Some currencies use a common deposit address for everyone on the exchange and designate the account for which this payment is destined by populating memo field. In these cases, use /v2/currencies to look up the mainAccount for the currency to find the deposit address and use the address returned by /v2/wallets/addresses or generate one using /v2/wallets/address as the memo. Note: /v2/currencies will only include a mainAccount property for currencies which require a memo.

Request Parameter	Data Type	Required	Description
coin	String	true	the currency to use for the deposit address, like”BTC, USDT or USDD”
network	String	true	The target network to withdraw to, like”BTC, ETH or TRX”
amount	String	true	withdrawal amount.
address	String	true	withdrawal address.
addressTag	String	false	memo for currencies that use a command deposit address.
allowBorrow	Boolean	false	allow to transfer borrowed funds (Default: false)

Example request:

{
    "coin": "ETH",
    "network": "ETH",
    "amount": "1.50",
    "address": "0xbb8d0d7c346daecc2380dabaa91f3ccf8ae232fb4"
}

Response Field	Data Type	Description
withdrawalRequestsId	Long	the withdrawal reference ID

Example output:

{
    "withdrawalRequestsId": 33485231
}

Wallets

Deposit Addresses​

Wallets Activity Records​

New Currency Address​

Withdraw Currency​

Withdraw Currency V2​

Deposit Addresses

Wallets Activity Records

New Currency Address

Withdraw Currency

Withdraw Currency V2