Skip to content

transfers

Methods exposed through client.transfers(network).

get_asset_transfers

Fetches historical transfers for an address, contract, or block range via the alchemy_getAssetTransfers JSON-RPC method.

Parameters:

Name Type Description Default
params AssetTransfersParams

Request payload.

required
validate bool | None

Validation override for this request.

None

Returns:

Type Description
AssetTransfersResponse

The validated endpoint response.

References
Source code in pkg/src/alchemy/api/transfers/get_asset_transfers.py
async def get_asset_transfers(
  self,
  params: AssetTransfersParams,
  *,
  validate: bool | None = None
) -> AssetTransfersResponse:
  """Fetches historical transfers for an address, contract, or block range via the `alchemy_getAssetTransfers` JSON-RPC method.

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

  Returns:
    The validated endpoint response.

  References:
    - [Alchemy API docs](https://www.alchemy.com/docs/data/transfers-api/transfers-endpoints/alchemy-get-asset-transfers)
  """
  r = await self.rpc_request('alchemy_getAssetTransfers', params, validate=validate)
  return adapter.python(r) if self.should_validate(validate) else r

get_asset_transfers_paged

Paged version of get_asset_transfers.

Parameters:

Name Type Description Default
params AssetTransfersBaseParams

Request payload.

required
validate bool | None

Validation override for each request.

None

Returns:

Type Description
PaginatedResponse[Transfer, str]

An async iterable and awaitable paginated response over transfers.

References
Source code in pkg/src/alchemy/api/transfers/get_asset_transfers.py
def get_asset_transfers_paged(
  self, params: AssetTransfersBaseParams, *, validate: bool | None = None,
) -> PaginatedResponse[Transfer, str]:
  """Paged version of get_asset_transfers.

  Args:
    params: Request payload.
    validate: Validation override for each request.

  Returns:
    An async iterable and awaitable paginated response over transfers.

  References:
    - [Alchemy API docs](https://www.alchemy.com/docs/data/transfers-api/transfers-endpoints/alchemy-get-asset-transfers)
  """
  return self.transfers_paged(params, validate=validate)

transfers

Fetch asset transfers.

Parameters:

Name Type Description Default
params AssetTransfersParams

Transfer filter parameters.

required
validate bool | None

Validation override for this request.

None

Returns:

Type Description
AssetTransfersResponse

The validated transfer response.

References
Source code in pkg/src/alchemy/api/transfers/get_asset_transfers.py
async def transfers(self, params: AssetTransfersParams, *, validate: bool | None = None) -> AssetTransfersResponse:
  """Fetch asset transfers.

  Args:
    params: Transfer filter parameters.
    validate: Validation override for this request.

  Returns:
    The validated transfer response.

  References:
    - [Alchemy API docs](https://www.alchemy.com/docs/data/transfers-api/transfers-endpoints/alchemy-get-asset-transfers)
  """
  return await self.get_asset_transfers(params, validate=validate)

transfers_paged

Paged version of transfers.

Parameters:

Name Type Description Default
params AssetTransfersBaseParams

Request payload.

required
validate bool | None

Validation override for each request.

None

Returns:

Type Description
PaginatedResponse[Transfer, str]

An async iterable and awaitable paginated response over transfers.

References
Source code in pkg/src/alchemy/api/transfers/get_asset_transfers.py
def transfers_paged(
  self, params: AssetTransfersBaseParams, *, validate: bool | None = None,
) -> PaginatedResponse[Transfer, str]:
  """Paged version of transfers.

  Args:
    params: Request payload.
    validate: Validation override for each request.

  Returns:
    An async iterable and awaitable paginated response over transfers.

  References:
    - [Alchemy API docs](https://www.alchemy.com/docs/data/transfers-api/transfers-endpoints/alchemy-get-asset-transfers)
  """
  state = ''

  async def next(state: str):
    page_params: AssetTransfersParams = {**params}
    if state:
      page_params['pageKey'] = state
    r = await self.get_asset_transfers(page_params, validate=validate)
    return r['transfers'], r.get('pageKey')

  return PaginatedResponse(state, next)