Skip to main content
GET
Get perpetual trade history
10 credits per request

  • Synced exchange trade records with prices, realized P&L and fees where available
  • portfolioId: Owned exchange or parent from GET /portfolio/list. Omit for all owned exchanges.
  • limit: 1 to 100, default 20. skip: 0 to 10000, default 0.
  • Uses the last portfolio sync and existing connector coverage. Records may group executions into positions. Unavailable fields are null; funding payments are not included.
  • Realized P&L follows the connector basis. BingX includes trading fees and funding; do not subtract fees again without checking the connector basis.
  • Newest first by opening time. Use nextSkip for another page; new records can shift offsets and a full page may be followed by an empty page.

Authorizations

X-API-KEY
string
header
required

API key required to access the endpoints. Generate one from your dashboard at https://openapi.coinstats.app and pass it in the X-API-KEY request header. Never expose your key in client-side code.

Query Parameters

portfolioId
string

Owned exchange or parent portfolio from GET /portfolio/list. Omit for all owned exchanges.

limit
integer
default:20
Required range: 1 <= x <= 100
skip
integer
default:0
Required range: 0 <= x <= 10000

Response

trades
object[]
required
nextSkip
number | null
required

Next offset, or null at the end or the offset limit. A full page may be followed by an empty page.