Price API

Token Price and Spread

Get the price and spread of the base token in terms of the quote token.

The spread represents the difference between the buy price and the sell price of the base token. The price returned represents the average of the buy price and the sell price.

GET https://api.propellerheads.xyz/partner/v2/solver/token_price_and_spread

Request

The query parameters needed to call the token_price_and_spread endpoint are:

Query Parameter	Description
blockchain	(string) The blockchain of the token for which we would like the price of.
quote_token_address	(string) The address of the token that will be used to describe the price of the base currency
base_token_address	(string) The address of the token that we would like the price of

Example

curl -X 'GET' \
  'https://api.propellerheads.xyz/partner/v2/solver/token_price_and_spread?blockchain=ethereum&quote_token_address=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48&base_token_address=0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2' \
  -H 'accept: application/json'
  -H 'x-api-key: <api-key>'

Response

The response from the token_price_and_spread endpoint looks like:

{
  "price": 2514.198145,
  "spread": 1.034862
}

Where the price field represents our price for the given base token in the quote token, and the spread field represents the difference between the buy price and the sell price of the base token.

For the example of our specific request, this means that mid price of 1 WETH is 2514.198145 USDC, and that the buy and sell prices of 1 WETH are 2515.233007 USDC and 2513.163283 USDC respectively (1.034862 USDC apart).