testsuite

func RunAdapterComplianceTests ¶

func RunAdapterComplianceTests(t *testing.T, adp exchanges.Exchange, symbol string)

RunAdapterComplianceTests runs a standard set of compliance tests against any exchanges.

func RunAnalyticsComplianceTests ¶ added in v0.2.19

func RunAnalyticsComplianceTests(t *testing.T, perp exchanges.PerpExchange, symbol string)

RunAnalyticsComplianceTests exercises the P0 analytics surface against a real perp adapter. Adapters that have not yet implemented a given capability should return ErrNotSupported; those sub-tests will be skipped.

perp is the PerpExchange under test. symbol is a base symbol known to be actively traded (e.g. "BTC") so statistics are populated.

func RunLifecycleSuite ¶

func RunLifecycleSuite(t *testing.T, adp exchanges.Exchange, cfg LifecycleConfig)

RunLifecycleSuite executes a comprehensive trading lifecycle test:

1. Subscribe — WatchOrders, collect all order state transitions
2. Open — Place a market buy and wait for FILLED
3. Verify — Check position (perp) or balance change (spot)
4. Close — Reverse the position while monitoring state transitions
5. Verify — Assert position/balance is restored
6. Disconnect — StopWatchOrders, Close

This test is intentionally a single sequential flow to validate that all pieces work together end-to-end.

func RunOrderQuerySemanticsSuite ¶ added in v0.2.0

func RunOrderQuerySemanticsSuite(t *testing.T, adp exchanges.Exchange, cfg OrderQueryConfig)

RunOrderQuerySemanticsSuite verifies the semantic split between: - FetchOrderByID: single-order lookup - FetchOrders: all visible orders for a symbol - FetchOpenOrders: open orders only

func RunOrderSuite ¶

func RunOrderSuite(t *testing.T, adp exchanges.Exchange, cfg OrderSuiteConfig)

RunOrderSuite runs a complete order placement test suite against any Exchange.

func RunTradingAccountSuite ¶ added in v0.2.9

func RunTradingAccountSuite(t *testing.T, adp exchanges.Exchange, cfg TradingAccountConfig)

func SetupOrderWatch ¶

func SetupOrderWatch(t *testing.T, adp exchanges.Exchange) <-chan *exchanges.Order

SetupOrderWatch subscribes to order updates via WatchOrders (Streamable) and returns a channel that receives all order updates.

func SmartLimitPrice ¶

func SmartLimitPrice(t *testing.T, adp exchanges.Exchange, symbol string, side exchanges.OrderSide) decimal.Decimal

SmartLimitPrice calculates a passive limit price that won't fill immediately.

func SmartQuantity ¶

func SmartQuantity(t *testing.T, adp exchanges.Exchange, symbol string) (qty, price decimal.Decimal)

SmartQuantity calculates a reasonable order quantity for testing.

func TestFetchAccount ¶

func TestFetchAccount(t *testing.T, adp exchanges.Exchange)

TestFetchAccount verifies the FetchAccount implementation

func TestFetchFeeRate ¶

func TestFetchFeeRate(t *testing.T, adp exchanges.Exchange, symbol string)

TestFetchFeeRate verifies the FetchFeeRate implementation

func TestFetchFundingRateHistory ¶ added in v0.2.19

func TestFetchFundingRateHistory(t *testing.T, perp exchanges.PerpExchange, symbol string)

TestFetchFundingRateHistory verifies a default call returns >=1 entry and respects the Limit option.

func TestFetchHistoricalTrades ¶ added in v0.2.19

func TestFetchHistoricalTrades(t *testing.T, adp exchanges.Exchange, symbol string)

TestFetchHistoricalTrades verifies a default call returns trades and the Limit option is honored.

func TestFetchOpenInterest ¶ added in v0.2.19

func TestFetchOpenInterest(t *testing.T, perp exchanges.PerpExchange, symbol string)

TestFetchOpenInterest verifies OI is positive and timestamp is recent.

func TestFetchOrderBook ¶

func TestFetchOrderBook(t *testing.T, adp exchanges.Exchange, symbol string)

TestFetchOrderBook verifies the FetchOrderBook implementation

func TestFetchSymbolDetails ¶

func TestFetchSymbolDetails(t *testing.T, adp exchanges.Exchange, symbol string)

TestFetchSymbolDetails verifies the FetchSymbolDetails implementation

func TestFetchTicker ¶

func TestFetchTicker(t *testing.T, adp exchanges.Exchange, symbol string)

TestFetchTicker verifies the FetchTicker implementation

func TestTickerExtendedStats ¶ added in v0.2.19

func TestTickerExtendedStats(t *testing.T, adp exchanges.Exchange, symbol string)

TestTickerExtendedStats verifies FetchTicker populates at least the 24h-change / open-price / trade-count fields for active symbols. Adapters that genuinely cannot surface a given field can document that omission in their own adapter_test.

func TestWatchOrderBook ¶

func TestWatchOrderBook(t *testing.T, adp exchanges.Exchange, symbol string)

TestWatchOrderBook verifies the WebSocket OrderBook subscription and local syncing

func WaitOrderStatus ¶

func WaitOrderStatus(
	t *testing.T,
	ch <-chan *exchanges.Order,
	orderID, clientID string,
	target exchanges.OrderStatus,
	timeout time.Duration,
) *exchanges.Order

WaitOrderStatus blocks until an order with matching orderID or clientID reaches the target status, or times out.