Price Store

Pricestore API contains endpoints that provide the latest price of a token as well as historical price of the tokens, these tokens can also be LP tokens. Tokens supported from ETH/BSC/Matic chains These api's also provide top losers and gainers.

Get Price by Symbol

This api provides price of token by taking the symbol of the token(ticker) as a parameter which will give latest price, timestamp can also be provided as a query param to get historical data.

Request
Security:
path Parameters
symbol
required
string
Default: "marsh"

Valid token ticker on ETH/BSC/Polygon

query Parameters
timestamp
string

Provide unix timestamp to fetch price

Responses
200

Example response

401
get/v1/pricestore/{symbol}
Request samples
curl -i -X GET \
  'https://api.unmarshal.com/v1/pricestore/:symbol?timestamp=string&auth_key=YOUR_API_KEY_HERE'
Response samples
application/json
[
  • {
    },
  • {
    }
]

Get Price by Address

This api provides price of a token by taking the address of the token(contract of token) in any chain such as Ethereum, Matic and Binance, timestamp can be provided as a query parameter to view historical data.

Request
Security:
path Parameters
chain
required
string

Chain name (example: bsc, ethereum, matic...)

Enum: "ethereum" "bsc" "matic" "celo" "avalanche" "xinfin" "zilliqa" "solana" "fantom" "bsc-testnet" "matic-testnet" "rinkeby-testnet"
Example: bsc
address
required
string

Any valid token address

query Parameters
timestamp
string

Provide unix timestamp to fetch price

24change
string

Specify param to fetch 24h change in price

alternateChain
string

Set true to fetch from other chains if not found in current chain

Responses
200

Example response

401
get/v1/pricestore/chain/{chain}/{address}
Request samples
curl -i -X GET \
  'https://api.unmarshal.com/v1/pricestore/chain/:chain/:address?timestamp=string&24change=string&alternateChain=string&auth_key=YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "tokenId": "0x5a666c7d92e5fa7edcb6390e4efd6d0cdd69cf37",
  • "timestamp": "1637922456",
  • "price": "1.2107928183"
}

Get Price for multiple Token Addresses

This api takes multiple contract addresses to provide price data at once, timestamp can be provided as a query parameter to view historical data. multiple contracts have to given in comma(,) separated.

Request
Security:
path Parameters
chain
required
string

Chain name (example: bsc, ethereum, matic...)

Enum: "ethereum" "bsc" "matic" "celo" "avalanche" "xinfin" "zilliqa" "solana" "fantom" "bsc-testnet" "matic-testnet" "rinkeby-testnet"
Example: bsc
query Parameters
tokens
string

List of comma separated token contracts

Responses
200

Example response

401
get/v1/pricestore/chain/{chain}/tokens
Request samples
curl -i -X GET \
  'https://api.unmarshal.com/v1/pricestore/chain/:chain/tokens?tokens=string&auth_key=YOUR_API_KEY_HERE'
Response samples
application/json
[
  • {
    },
  • {
    }
]

Top Gainers

API provides a list of top gainers in a particular chain. the data contains biggest gainers in last 24 hours.

Request
Security:
path Parameters
chain
required
string

Chain name (example: bsc, ethereum, matic...)

Enum: "ethereum" "bsc" "matic" "celo" "avalanche" "xinfin" "zilliqa" "solana" "fantom" "bsc-testnet" "matic-testnet" "rinkeby-testnet"
Example: bsc
query Parameters
price
string

Result for price greater than given value

Responses
200

Example response

401
get/v1/pricestore/chain/{chain}/gainers
Request samples
curl -i -X GET \
  'https://api.unmarshal.com/v1/pricestore/chain/:chain/gainers?price=string&auth_key=YOUR_API_KEY_HERE'
Response samples
application/json
[]

Top Losers

API provides a list of top losers in a particular chain. the data contains biggest losers in last 24 hours.

Request
Security:
path Parameters
chain
required
string

Chain name (example: bsc, ethereum, matic...)

Enum: "ethereum" "bsc" "matic" "celo" "avalanche" "xinfin" "zilliqa" "solana" "fantom" "bsc-testnet" "matic-testnet" "rinkeby-testnet"
Example: bsc
query Parameters
price
string

Result for price greater than given value

Responses
200

Example response

401
get/v1/pricestore/chain/{chain}/losers
Request samples
curl -i -X GET \
  'https://api.unmarshal.com/v1/pricestore/chain/:chain/losers?price=string&auth_key=YOUR_API_KEY_HERE'
Response samples
application/json
[]

Price for LP Tokens

This api provides the price for LP tokens by taking in the address of the Lp tokens.

Request
Security:
path Parameters
chain
required
string

Chain name (example: bsc, ethereum, matic...)

Enum: "ethereum" "bsc" "matic" "celo" "avalanche" "xinfin" "zilliqa" "solana" "fantom" "bsc-testnet" "matic-testnet" "rinkeby-testnet"
Example: bsc
query Parameters
lptokens
required
string

Any valid LP token address

Responses
200

Example response

401
get/v1/pricestore/chain/{chain}/lptokens
Request samples
curl -i -X GET \
  'https://api.unmarshal.com/v1/pricestore/chain/:chain/lptokens?lptokens=string&auth_key=YOUR_API_KEY_HERE'
Response samples
application/json
[
  • {
    }
]