Get unified perp activity

get

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

Paginated chronological feed of timeline events and user actions for an address on one or more providers (newest first). Pass providerId or providerIds. Events use occurredAt; actions use createdAt.

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

actionStatus

string

enum

If provided, filters only action items by their status. Timeline events are not affected.

Allowed:

actionStatuses

array of strings

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

actionStatuses

Allowed:

Responses

200Paginated unified activity

401Invalid or missing API key

429Rate limit exceeded