跳到主要内容

Reference Data

Symbol Information

  • GET https://api.poloniex.com/markets
  • GET https://api.poloniex.com/markets/{symbol}

/markets: get all symbols and their tradeLimit info. priceScale is referring to the max number of decimals allowed for a given symbol. For example, priceScale of 2 implies accepted values like 200.34, 13.2, 100 and priceScale of 0 implies accepted values like 200, 92, 13. Fields quantityScale and amountScale work in similar fashion. minQuantity and minAmount refer to the minimum size of the order.

Response FieldData TypeDescription
symbolStringsymbol name
baseCurrencyNameStringbase currency name
quoteCurrencyNameStringquote currency name
displayNameStringsymbol display name
stateStringNORMAL, PAUSE, POST_ONLY
visibleStartTimeLongtime since symbol is visible in the frontend
tradableStartTimeLongtime since symbol is tradable
symbolTradeLimitMapsymbol market configuration
crossMarginMapsymbol cross margin info
symbolTradeLimit field
Response FieldData TypeDescription
symbolStringsymbol name
priceScaleIntegerdecimal precision for price
quantityScaleIntegerdecimal precision for quantity
amountScaleIntegerdecimal precision for amount
minQuantityStringminimum required quantity
minAmountStringminimum required amount
highestBidStringmaximum allowed bid price (market bound)
lowestAskStringminimum allowed ask price (market bound)
crossMargin field
Response FieldData TypeDescription
supportCrossMarginBooleanindicates if symbol supports cross margin
maxLeverageIntegermaximum supported leverage

/markets/{symbol}: get a single symbol and its tradeLimit info.

Request ParameterData TypeRequiredDescription
symbolStringtruesymbol name

Response fields and symbolTradeLimit fields are the same as those of /markets

Example output:
[
{
"symbol": "BTC_USDT",
"baseCurrencyName": "BTC",
"quoteCurrencyName": "USDT",
"displayName": "BTC/USDT",
"state": "NORMAL",
"visibleStartTime": 1659018819512,
"tradableStartTime": 1659018819512,
"symbolTradeLimit": {
"symbol": "BTC_USDT",
"priceScale": 2,
"quantityScale": 6,
"amountScale": 2,
"minQuantity": "0.000001",
"minAmount": "1",
"highestBid": "0",
"lowestAsk": "0"
},
"crossMargin": {
"supportCrossMargin": true,
"maxLeverage": 3
}
},
{
"symbol": "ETH_USDT",
"baseCurrencyName": "ETH",
"quoteCurrencyName": "USDT",
"displayName": "ETH/USDT",
"state": "NORMAL",
"visibleStartTime": 1659018820007,
"tradableStartTime": 1659018820007,
"symbolTradeLimit": {
"symbol": "ETH_USDT",
"priceScale": 2,
"quantityScale": 6,
"amountScale": 2,
"minQuantity": "0.000001",
"minAmount": "1",
"highestBid": "0",
"lowestAsk": "0"
},
"crossMargin": {
"supportCrossMargin": true,
"maxLeverage": 3
}
},

]

Currency Information

  • GET https://api.poloniex.com/currencies
  • GET https://api.poloniex.com/currencies/{currency}

/currencies: get all supported currencies

Request ParameterData TypeRequiredDescription
includeMultiChainCurrenciesBooleanfalseDefault is false. Indicates if multi chain currencies are included. If set to true, additionally adds a new row for each currency on their respective chain (i.e USDT, USDTETH, USDTTRON will all have entries).
Response FieldData TypeDescription
currencyJsontable below
currency fields
Response FieldData TypeDescription
idIntegercurrency id
nameStringcurrency name
descriptionStringthe type of blockchain the currency runs on
typeStringcurrency type
withdrawalFeeStringThe network fee necessary to withdraw this currency
minConfIntegerthe minimum number of blocks necessary before a deposit can be credited to an account
depositAddressStringif available, the deposit address for this currency.
blockchainStringthe blockchain the currency runs on
delistedBooleandesignates whether (true) or not (false) this currency has been delisted from the exchange
tradingStateStringcurrency trading state: NORMAL or OFFLINE
walletStateStringcurrency state: ENABLED or DISABLED
walletDepositStateStringcurrency deposit state: ENABLED or DISABLED
walletWithdrawalStateStringcurrency withdrawal state: ENABLED or DISABLED
parentChainStringonly displayed when includeMultiChainCurrencies is set to true. The parent chain
isMultiChainBooleanonly displayed when includeMultiChainCurrencies is set to true. Indicates whether (true) or not (false) this currency is a multi chain
isChildChainBooleanonly displayed when includeMultiChainCurrencies is set to true. Indicates whether (true) or not (false) this currency is a child chain
supportCollateralBooleanindicates if this currency supports collateral in cross margin
supportBorrowBooleanindicates if this currency supports borrows in cross margin
childChainsArray of Stringonly displayed when includeMultiChainCurrencies is set to true. The child chains
Example output:
[
{
"ETH" : {
"id" : 267,
"name" : "Ethereum",
"description" : "Sweep to Main Account",
"type" : "address",
"withdrawalFee" : "0.00107535",
"minConf" : 12,
"depositAddress" : null,
"blockchain" : "ETH",
"delisted" : false,
"tradingState" : "NORMAL",
"walletState" : "ENABLED",
"walletDepositState" : "ENABLED",
"walletWithdrawalState" : "ENABLED",
"parentChain" : null,
"isMultiChain" : true,
"isChildChain" : false,
"supportCollateral": false,
"supportBorrow": false,
"childChains" : [ "ETHTRON" ]
}
},
{
"ABY": {
"id": 2,
"name": "ArtByte",
"description": "BTC Clone",
"type": "address",
"withdrawalFee": "0.01000000",
"minConf": 10000,
"depositAddress": null,
"blockchain": "ABY",
"delisted": true,
"tradingState": "OFFLINE",
"walletState": "DISABLED",
"walletDepositState" : "DISABLED",
"walletWithdrawalState" : "DISABLED",
"parentChain": null,
"isMultiChain": false,
"isChildChain": false,
"supportCollateral": false,
"supportBorrow": false,
"childChains": []
}
},
...
]

/currencies/{currency}: get data for a supported currency

Request ParameterData TypeRequiredDescription
currencyStringtruecurrency name
includeMultiChainCurrenciesBooleanfalseDefault is false. Indicates if multi chain currencies are included. If set to true, additionally adds a new row for each currency on their respective chain (i.e USDT, USDTETH, USDTTRON will all have entries).

The response field and currency fields are the same as those of /currencies

Example output:
{
"BNB": {
"id": 343,
"name": "Binance Coin",
"description": "Sweep to Main Account",
"type": "address-payment-id",
"withdrawalFee": "0.00000001",
"minConf": 0,
"depositAddress": null,
"blockchain": "BNB",
"delisted": false,
"tradingState": "NORMAL",
"walletState": "ENABLED",
"walletDepositState" : "ENABLED",
"walletWithdrawalState" : "ENABLED",
"parentChain": null,
"isMultiChain": true,
"isChildChain": false,
"supportCollateral": true,
"supportBorrow": false,
"childChains": [
"BSC"
]
}
}

CurrencyV2 Information

  • GET https://api.poloniex.com/v2/currencies
  • GET https://api.poloniex.com/v2/currencies/{currency}

/v2/currencies: get all supported currencies

Response FieldData TypeDescription
currencyJsontable below
currency fields
Response FieldData TypeDescription
idIntegercurrency id
coinStringcurrency symbol
delistedBooleandesignates whether (true) or not (false) this currency has been delisted from the exchange
tradeEnableBooleandesignates whether (true) or not (false) this currency can be traded on the exchange
nameStringcurrency name
supportCollateralBooleanindicates if this currency supports collateral in cross margin
supportBorrowBooleanindicates if this currency supports borrows in cross margin
networkListArray of Jsonthe networks the currency runs on
Response FieldData TypeDescription
idIntegercurrency id
coinStringcurrency symbol
nameStringcurrency name
currencyTypeStringcurrency type: address or address-payment-id
blockchainStringthe networks the currency runs on
withdrawalEnableBooleandesignates whether (true) or not (false) this currency can be withdrawn
depositEnableBooleandesignates whether (true) or not (false) this currency can be allowed to deposit
depositAddressStringif available, the deposit address for this currency
withdrawMinStringThe minimum withdrawal amount, or a number less than or equal to 0 if none
decimalsStringdecimals of currency
withdrawFeeStringwithdraw fee of currency
minConfirmIntegerthe minimum number of blocks necessary before a deposit can be credited to an account
Example output:
[
{
"id": 1,
"coin": "1CR",
"delisted": true,
"tradeEnable": false,
"name": "1CRedit",
"networkList": [
{
"id": 1,
"coin": "1CR",
"name": "1CRedit",
"currencyType": "address",
"blockchain": "1CR",
"withdrawalEnable": false,
"depositEnable": false,
"depositAddress": null,
"withdrawMin": null,
"decimals": 8,
"withdrawFee": "0.01000000",
"minConfirm": 10000
}
]
},
{
"id": 446,
"coin": "AAVE",
"delisted": false,
"tradeEnable": true,
"name": "Aave",
"networkList": [
{
"id": 446,
"coin": "AAVE",
"name": "Ethereum",
"currencyType": "address",
"blockchain": "ETH",
"withdrawalEnable": true,
"depositEnable": true,
"depositAddress": null,
"withdrawMin": null,
"decimals": 8,
"withdrawFee": "0.22553338",
"minConfirm": 12
}
],
"supportCollateral": false,
"supportBorrow": false
},
...
]

/v2/currencies/{currency}: get data for a supported currency

Request ParameterData TypeRequiredDescription
currencyStringtruecurrency name

The response field and currency fields are the same as those of /v2/currencies

Example output:
{
"id" : 315,
"coin" : "TRX",
"delisted" : false,
"tradeEnable" : true,
"name" : "Tron",
"networkList" : [ {
"id" : 536,
"coin" : "TRXETH",
"name" : "Ethereum",
"currencyType" : "address",
"blockchain" : "ETH",
"withdrawalEnable" : false,
"depositEnable" : true,
"depositAddress" : null,
"decimals" : 6,
"withdrawMin" : null,
"withdrawFee" : "0.00000000",
"minConfirm" : 12
}, {
"id" : 315,
"coin" : "TRX",
"name" : "Tron",
"currencyType" : "address",
"blockchain" : "TRX",
"withdrawalEnable" : true,
"depositEnable" : true,
"depositAddress" : null,
"decimals" : 8,
"withdrawMin" : null,
"withdrawFee" : "0.00000000",
"minConfirm" : 0
} ],
"supportCollateral" : true,
"supportBorrow" : true
}

System Timestamp

  • GET https://api.poloniex.com/timestamp

Get current server time.

Example output:
{
"serverTime": 1649671195385
}