Providers

Discover available DEX providers, their capabilities, markets, and actions

getProviders

Returns all available perpetual DEX platforms, including their prepareAccountActions, trading actions, and markets.

import { createPerpsClient, getProviders } from '@lifi/perps-sdk';

const client = createPerpsClient({ integrator: 'my-app' });
const { providers } = await getProviders(client);

for (const provider of providers) {
  console.log(provider.key, provider.name);
  console.log('  markets:', provider.markets.map((m) => m.id));
  console.log('  actions:', provider.actions.map((a) => a.type));
}
// hyperliquid Hyperliquid
//   markets: ['hyperliquid', 'xyz', 'flx', 'spot', ...]
//   actions: ['placeOrder', 'cancelOrder', 'modifyOrder', ...]

Parameters

Parameter	Type	Required	Description
client	PerpsSDKClient	Yes	SDK client from createPerpsClient()
options	SDKRequestOptions	No	Request options (e.g., signal for cancellation)

Returns

ProvidersResponse — { providers: Provider[] }:

Each Provider:

Field	Type	Description
key	string	Unique provider identifier (used in query params)
name	string	Display name
logoURI	string	URL to provider logo image
prepareAccountActions	ActionDescriptor[]	Account setup actions (prerequisites) with their allowed signers
actions	ActionDescriptor[]	Trading/operational actions with their allowed signers
markets	ProviderMarketInfo[]	Sub-markets within the provider (e.g., perps, spot, xyz)
wsUrl	string?	WebSocket endpoint for streaming (see Streaming)

Each ProviderMarketInfo:

Field	Type	Description
id	string	Market identifier (used as market in AssetIdentity)
quoteAsset	string | null	Quote asset for this market (e.g., "USDC")

Each ActionDescriptor:

Field	Type	Description
type	ActionType	Action type string
signers	PerpsSigner[]	Allowed signers: "USER" or "AGENT"

Use provider.prepareAccountActions to dynamically build the prerequisites UI. See Hyperliquid / Prerequisites for the full flow.

API Reference: GET /providers