from typing import Union
from ..asset import Asset
from ..call_builder.base_call_builder import BaseCallBuilder
from ..client.base_async_client import BaseAsyncClient
from ..client.base_sync_client import BaseSyncClient
[docs]class TradesCallBuilder(BaseCallBuilder):
""" Creates a new :class:`TradesCallBuilder` pointed to server defined by horizon_url.
Do not create this object directly, use :func:`stellar_sdk.server.Server.trades`.
See `Trades <https://www.stellar.org/developers/horizon/reference/endpoints/trades.html)>`_
:param horizon_url: Horizon server URL.
:param client: The client instance used to send request.
"""
def __init__(
self, horizon_url: str, client: Union[BaseAsyncClient, BaseSyncClient]
) -> None:
super().__init__(horizon_url, client)
self.endpoint: str = "trades"
[docs] def for_asset_pair(self, base: Asset, counter: Asset) -> "TradesCallBuilder":
"""Filter trades for a specific asset pair (orderbook)
:param base: base asset
:param counter: counter asset
:return: current TradesCallBuilder instance
"""
params = {
"base_asset_type": base.type,
"base_asset_code": None if base.is_native() else base.code,
"base_asset_issuer": base.issuer,
"counter_asset_type": counter.type,
"counter_asset_code": None if counter.is_native() else counter.code,
"counter_asset_issuer": counter.issuer,
}
self._add_query_params(params)
return self
[docs] def for_offer(self, offer_id: Union[int, str]) -> "TradesCallBuilder":
"""Filter trades for a specific offer
See `Trades for Offer <https://www.stellar.org/developers/horizon/reference/endpoints/trades-for-offer.html>`_
:param offer_id: offer id
:return: current TradesCallBuilder instance
"""
self.endpoint = f"offers/{offer_id}/trades"
return self
[docs] def for_account(self, account_id: str) -> "TradesCallBuilder":
"""Filter trades for a specific account
See `Trades for Account <https://www.stellar.org/developers/horizon/reference/endpoints/trades-for-account.html>`_
:param account_id: account id
:return: current TradesCallBuilder instance
"""
self.endpoint = f"accounts/{account_id}/trades"
return self