Get user actions

get

https://perps.yield.xyz/v1/actions

Retrieve all actions performed by a user on a specific provider, with optional filtering by status and action type. Returns a paginated list ordered by most recent first.

Query Params

offset

number

≥ 0

Defaults to 0

Offset for pagination

limit

number

1 to 500

Defaults to 100

Maximum number of items to return

providerId

string

enum

Single provider identifier. At least one of providerId or providerIds must be provided.

Allowed:

providerIds

array of strings

Filter by multiple providers (CSV, repeated query params, or JSON array). At least one of providerId or providerIds must be provided. When both providerId and providerIds are set, results include all listed providers.

providerIds

Allowed:

address

string

required

User wallet address

status

string

enum

Filter by action status

Allowed:

statuses

array of strings

Filter by multiple action statuses (supports CSV or repeated query params)

statuses

Allowed:

type

string

enum

Filter by action type

marketId

string

Filter by market (e.g. hyperliquid-eth-usdc)

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Paginated list of user actions

400See https://docs.yield.xyz for details.code values. ValidationPipe failures use validation.message: string[] in place of details.

401Invalid or missing API key

429Rate limit exceeded