Skip to main content
GET
/
api
/
personal-trading-history
/
{address}
Get Wallet Trading History
curl --request GET \
  --url https://backend-global.gains.trade/api/personal-trading-history/{address}
{
  "data": [
    {}
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": 123,
    "limit": 123
  }
}

​
Endpoint

GET /api/personal-trading-history/{address} Returns paginated trading history for one wallet.

​
Parameters

ParameterLocationRequiredTypeDescription
addresspathYesstringTrader wallet address.
chainIdqueryYesintegerBlockchain chain ID. Common values: 42161 Arbitrum, 8453 Base, 137 Polygon.
cursorqueryNointegerPagination cursor.
limitqueryNointegerItems to return.
startDatequeryNostringOptional ISO start date.
endDatequeryNostringOptional ISO end date.
pairqueryNostringOptional pair filter.
actionqueryNostringOptional action filter.

​
Usage Example

curl -X GET "https://backend-global.gains.trade/api/personal-trading-history/0x0000000000000000000000000000000000000000?chainId=42161&limit=50"

​
Response Structure

The generated API panel lists the response schema for status codes: 200, 400, 500. Error responses generally return an error or message field.

Path Parameters

​
address
string
required

Trader wallet address.

Query Parameters

​
chainId
integer
required

Blockchain chain ID. Common values: 42161 Arbitrum, 8453 Base, 137 Polygon.

Example:

42161

​
cursor
integer

Pagination cursor.

​
limit
integer

Items to return.

Example:

50

​
startDate
string

Optional ISO start date.

​
endDate
string

Optional ISO end date.

​
pair
string

Optional pair filter.

​
action
string

Optional action filter.

Response

Successful response

​
data
object[]
​
pagination
object