Tokens

REST endpoints for retrieving token information.

Rate limit is 120 requests/minute per IP address.

get
List Tokens

https://api.radarrelay.com/v2/tokens
Get all tokens
Request
Response
Path Parameters
optional
string
200: OK
[
{
"address": string,
"symbol": string,
"name": string,
"decimals": number,
"zeroex_official": boolean,
"active": boolean,
"createdDate": string,
"quote": boolean
}
]
400: Bad Request
Unknown error has occurred

get
Get Market

https://api.radarrelay.com/v2/markets/{marketId}
Return data for a single market.
Request
Response
Path Parameters
marketId
optional
string
Market ID in the format of {base}-{quote} e.g. ZRX-WETH
Query Parameters
include
optional
string
Comma-separated list specifying which parts of the RadarMarket Schema to include in the response. Valid options include 'base', 'ticker', 'stats', and 'history'. e.g. base,ticker,stats,history
200: OK
{
"id": string,
"ticker": RadarTicker,
"stats": RadarStats,
"history": RadarHistory
}
400: Bad Request
Unknown error occurred
404: Not Found
Market not found

get
Get Market Ticker

https://api.radarrelay.com/v2/markets/{marketId}/ticker
Return ticker data for a single market
Request
Response
Path Parameters
marketId
optional
string
Market id in the format of {base}-{quote}. e.g. ZRX-WETH
200: OK
{
"transactionHash": string,
"price": BigNumber,
"size": BigNumber,
"timestamp": BigNumber, // unix
"bestBid": BigNumber,
"bestAsk": BigNumber,
"spreadPercentage": BigNumber
}
400: Bad Request
Unknown error occured
404: Not Found
Market not found

get
Get Market Stats

https://api.radarrelay.com/v2/markets/{marketId}/stats
Get the stats for the specified market.
Request
Response
Path Parameters
marketId
optional
string
Market id in the format of {base}-{quote}. e.g. ZRX-WETH
200: OK
{
"numBidsWithinRange": number,
"numAsksWithinRange": number,
"baseTokenAvailable": BigNumber,
"quoteTokenAvailable": BigNumber,
"volume24Hour": BigNumber,
"percentChange24Hour": BigNumber
}
400: Bad Request
Unknown error occured
404: Not Found
Market not found

get
Get Market History

https://api.radarrelay.com/v2/markets/{marketId}/history
Get the history for the specified market.
Request
Response
Path Parameters
marketId
optional
string
Market id in the format of {base}-{quote}. e.g. ZRX-WETH
200: OK
{
"price24Hour": BigNumber[]
}
400: Bad Request
Unknown error occured
404: Not Found
Market not found

get
List Market Fills

https://api.radarrelay.com/v2/markets/{marketId}/fills
Return a paginated list of market fills sorted by fill date.
Request
Response
Path Parameters
marketId
optional
string
Market id in the format of {base}-{quote}. e.g. ZRX-WETH
Query Parameters
page
optional
integer
Page of fills to retrieve. Defaults to 1.
perPage
optional
integer
Number of fills to retrieve per page. Defaults to 20.
200: OK
[
{
"transactionHash": string,
"type": UserOrderType,
"blockNumber": number,
"makerAddress": string,
"takerAddress": string,
"baseTokenAddress": string;
"quoteTokenAddress": string;
"feeRecipientAddress": string;
"makerFeePaid": BigNumber,
"takerFeePaid": BigNumber,
"filledBaseTokenAmount": BigNumber,
"filledQuoteTokenAmount": BigNumber,
"orderHash": string,
"timestamp": number,
"outlier": boolean
}
]
400: Bad Request
Unknown error occured
404: Not Found
Market not found

get
List Market Candles

https://api.radarrelay.com/v2/markets/{marketId}/candles
Request
Response
Path Parameters
marketId
optional
string
Market id in the format of {base}-{quote}. e.g. ZRX-WETH
200: OK
[
{
"open": BigNumber,
"high": BigNumber,
"low": BigNumber,
"close": BigNumber,
"startBlock": number,
"startBlockTimestamp": number,
"endBlock": number,
"endBlockTimestamp": number,
"baseTokenVolume": BigNumber,
"quoteTokenVolume": BigNumber
}
]
400: Bad Request
Unknown error occured
404: Not Found
Market not found

get
Get Market Book

https://api.radarrelay.com/v2/markets/{marketId}/book
Return a book containing bids / asks for a market.
Request
Response
Path Parameters
marketId
optional
string
Market id in the format of {base}-{quote}. e.g. ZRX-WETH
200: OK
{
"baseTokenAddress": string,
"quoteTokenAddress": string,
"bids": RadarSignedOrder[],
"asks": RadarSignedOrder[]
}
400: Bad Request
Unknown error occured
404: Not Found
Market not found