1717import com .webull .openapi .core .utils .StringUtils ;
1818import com .webull .openapi .trade .http .ITradeV3Client ;
1919import com .webull .openapi .trade .request .v3 .*;
20+ import com .webull .openapi .trade .request .TransfersActivitiesRequest ;
2021import com .webull .openapi .trade .response .PaginatedResult ;
2122import com .webull .openapi .trade .response .TradeCalendar ;
23+ import com .webull .openapi .trade .response .Transfer ;
24+ import com .webull .openapi .trade .response .TransferDetail ;
2225import com .webull .openapi .trade .response .v3 .*;
2326
2427import java .util .*;
2528
2629public class TradeClientV3 implements ITradeV3Client {
2730
2831 private static final String ACCOUNT_ID_ARG = "accountId" ;
32+ private static final String REQUEST_ARG = "request" ;
2933 private static final String TRADE_ORDER_ARG = "tradeOrder" ;
3034 private static final String NEW_ORDERS_ARG = "newOrders" ;
3135 private static final String BATCH_ORDERS_ARG = "batchOrders" ;
3236 private static final String MODIFY_ORDERS_ARG = "modifyOrders" ;
3337 private static final String CLIENT_ORDER_ID_ARG = "clientOrderId" ;
3438 private static final String INSTRUMENT_ID_ARG = "instrumentId" ;
39+ private static final String TRANSFER_ID_ARG = "transferId" ;
3540
3641 private static final String PAGE_SIZE_PARAM = "page_size" ;
3742 private static final String START_DATE_PARAM = "start_date" ;
@@ -58,6 +63,12 @@ public class TradeClientV3 implements ITradeV3Client {
5863
5964 private static final String LAST_EXECUTION_ID_PARAM = "last_execution_id" ;
6065
66+ private static final String TRANSFER_METHOD_PARAM = "transfer_method" ;
67+ private static final String TRANSFER_ID_PARAM = "transfer_id" ;
68+ private static final String DIRECTION_PARAM = "direction" ;
69+ private static final String STATUS_PARAM = "status" ;
70+ private static final String ACATS_TRANSFER_TYPES_PARAM = "acats_transfer_types" ;
71+
6172 private static final String PAGINATION_KEY_PARAM = "pagination_key" ;
6273
6374 private final Region region ;
@@ -396,6 +407,52 @@ public PaginatedResult<Activity> getCashActivities(String accountId, String acti
396407 }.getType ()).doAction ();
397408 }
398409
410+ @ Override
411+ public PaginatedResult <Transfer > listTransfersActivities (TransfersActivitiesRequest request ) {
412+ assertUsRegion ("listTransfersActivities" );
413+ Assert .notNull (REQUEST_ARG , request );
414+ Assert .notBlank (ACCOUNT_ID_ARG , request .getAccountId ());
415+ HttpRequest httpRequest = new HttpRequest ("/trading/activities/transfer-activities/list" , Versions .V3 , HttpMethod .GET );
416+ Map <String , Object > params = new HashMap <>();
417+ params .put (ACCOUNT_ID_PARAM , request .getAccountId ());
418+ if (StringUtils .isNotEmpty (request .getTransferMethod ())) {
419+ params .put (TRANSFER_METHOD_PARAM , request .getTransferMethod ());
420+ }
421+ if (StringUtils .isNotEmpty (request .getDirection ())) {
422+ params .put (DIRECTION_PARAM , request .getDirection ());
423+ }
424+ if (StringUtils .isNotEmpty (request .getStatus ())) {
425+ params .put (STATUS_PARAM , request .getStatus ());
426+ }
427+ if (StringUtils .isNotEmpty (request .getAcatsTransferTypes ())) {
428+ params .put (ACATS_TRANSFER_TYPES_PARAM , request .getAcatsTransferTypes ());
429+ }
430+ if (StringUtils .isNotEmpty (request .getStartTime ())) {
431+ params .put (START_TIME_PARAM , request .getStartTime ());
432+ }
433+ if (StringUtils .isNotEmpty (request .getEndTime ())) {
434+ params .put (END_TIME_PARAM , request .getEndTime ());
435+ }
436+ if (StringUtils .isNotEmpty (request .getPaginationKey ())) {
437+ params .put (PAGINATION_KEY_PARAM , request .getPaginationKey ());
438+ }
439+ httpRequest .setQuery (params );
440+ return apiClient .request (httpRequest ).responseType (new TypeToken <PaginatedResult <Transfer >>() {
441+ }.getType ()).doAction ();
442+ }
443+
444+ @ Override
445+ public TransferDetail getTransferActivity (String accountId , String transferId ) {
446+ assertUsRegion ("getTransferActivity" );
447+ Assert .notBlank (Arrays .asList (ACCOUNT_ID_ARG , TRANSFER_ID_ARG ), accountId , transferId );
448+ HttpRequest request = new HttpRequest ("/trading/activities/transfer-activities/get" , Versions .V3 , HttpMethod .GET );
449+ Map <String , Object > params = new HashMap <>();
450+ params .put (ACCOUNT_ID_PARAM , accountId );
451+ params .put (TRANSFER_ID_PARAM , transferId );
452+ request .setQuery (params );
453+ return apiClient .request (request ).responseType (TransferDetail .class ).doAction ();
454+ }
455+
399456 @ Override
400457 public PaginatedResult <OrderExecution > getOrderExecutions (String accountId , String clientOrderId , String startDate ,
401458 String endDate , String paginationKey ) {
@@ -420,6 +477,14 @@ public PaginatedResult<OrderExecution> getOrderExecutions(String accountId, Stri
420477 }.getType ()).doAction ();
421478 }
422479
480+ private void assertUsRegion (String operation ) {
481+ if (region != Region .us ) {
482+ throw new ClientException (ErrorCode .NOT_SUPPORT ,
483+ operation + " is currently supported only for Webull US region, current region is "
484+ + region .name () + "." );
485+ }
486+ }
487+
423488 private void addCustomHeadersFromOrder (HttpRequest request , List <TradeOrderItem > orders ) {
424489 if (CollectionUtils .isEmpty (orders )
425490 || Objects .isNull (orders .get (0 ))) {
0 commit comments