Skip to content

prices

Methods exposed through client.prices.

by_address

Fetches current prices for up to 25 ERC-20 token contracts identified by network and address.

Parameters:

Name Type Description Default
request TokenPricesByAddressRequest

Request payload.

 required
validate bool | None

Validation override for this request.

 None

Returns:

Type Description
TokenPricesByAddressResponse

The validated endpoint response.
References
Source code in pkg/src/alchemy/api/prices/by_address.py 
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
async def by_address(self, request: TokenPricesByAddressRequest, *, validate: bool | None = None) -> TokenPricesByAddressResponse:
  """Fetches current prices for up to 25 ERC-20 token contracts identified by network and address.

  Args:
    request: Request payload.
    validate: Validation override for this request.

  Returns:
    The validated endpoint response.

  References:
    - [Alchemy API docs](https://www.alchemy.com/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-token-prices-by-address)
    """
  r = await self.request('POST', '/tokens/by-address', json=request)

  if r.status_code != 200:
    self.raise_error(r)
  return adapter.json(r.text) if self.should_validate(validate) else r.json()

by_symbol

Fetches current prices for up to 25 tokens identified by their ticker symbols.

Parameters:

Name Type Description Default
symbols list[str]

Array of token ticker symbols to fetch prices for. Maximum 25 symbols per request.

 required
validate bool | None

Validation override for this request.

 None

Returns:

Type Description
TokenPricesBySymbolResponse

The validated endpoint response.
References
Source code in pkg/src/alchemy/api/prices/by_symbol.py 
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
async def by_symbol(self, *, symbols: list[str], validate: bool | None = None) -> TokenPricesBySymbolResponse:
  """Fetches current prices for up to 25 tokens identified by their ticker symbols.

  Args:
    symbols: Array of token ticker symbols to fetch prices for. Maximum 25 symbols per request.
    validate: Validation override for this request.

  Returns:
    The validated endpoint response.

  References:
    - [Alchemy API docs](https://www.alchemy.com/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-token-prices-by-symbol)
    """
  params: dict = {
    'symbols': symbols,
  }
  r = await self.request('GET', '/tokens/by-symbol', params=params)

  if r.status_code != 200:
    self.raise_error(r)
  return adapter.json(r.text) if self.should_validate(validate) else r.json()

historical

Fetches historical price data for a token identified either by symbol or by network and contract address.

Parameters:

Name Type Description Default
request HistoricalTokenPricesRequest

Request payload.

 required
validate bool | None

Validation override for this request.

 None

Returns:

Type Description
HistoricalTokenPricesResponse

The validated endpoint response.
References
Source code in pkg/src/alchemy/api/prices/historical.py 
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
async def historical(self, request: HistoricalTokenPricesRequest, *, validate: bool | None = None) -> HistoricalTokenPricesResponse:
  """Fetches historical price data for a token identified either by symbol or by network and contract address.

  Args:
    request: Request payload.
    validate: Validation override for this request.

  Returns:
    The validated endpoint response.

  References:
    - [Alchemy API docs](https://www.alchemy.com/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-historical-token-prices)
    """
  r = await self.request('POST', '/tokens/historical', json=request)

  if r.status_code != 200:
    self.raise_error(r)
  return adapter.json(r.text) if self.should_validate(validate) else r.json()