Fomo API logoFOMO APIDOCS

Documentation

IntroductionAuthenticationQuickstartGETHealthGETLeaderboardGETResolve traderGETTrader balancesGETTrader spotlightGETTrader swapsGETTrader rankingGETAggregated snapshotWSTrade stream

[ API reference ]

Trader swaps

Returns a paginated stream of normalized token swaps completed by a selected trader.

GET/api/users/{userId}/swaps

This endpoint requires an API key using X-API-Key or Bearer authorization.

01

Request

curl

curl "https://getfomoapi.fun/api/users/{userId}/swaps" \
  -H "X-API-Key: YOUR_API_KEY"
02

Parameters

userIdpathUUIDUnique trader ID returned by the resolve trader endpoint.
limitqueryintegerMaximum number of swaps to return. Accepted range is 1 to 150.
cursorquerystringPagination cursor returned by a previous request.
03

Response fields

successbooleanIndicates whether the request succeeded.
responseObject.swapsarrayList of normalized swaps.
responseObject.swaps[].idstringUnique swap identifier.
responseObject.swaps[].networkIdintegerPrimary network identifier.
responseObject.swaps[].inTokenAddressstringToken address received by the trader.
responseObject.swaps[].inHumanAmountnumberHuman-readable received amount.
responseObject.swaps[].outTokenAddressstringToken address sent by the trader.
responseObject.swaps[].outHumanAmountnumberHuman-readable sent amount.
responseObject.swaps[].humanUsdAmountInnumberEstimated USD value received.
responseObject.swaps[].humanUsdAmountOutnumberEstimated USD value sent.
responseObject.swaps[].providerstring | nullSwap execution provider.
responseObject.hasNextPagebooleanIndicates whether more swaps are available.
statusCodeintegerHTTP status represented in the response.
04

JSON response

A successful request returns the following response structure.

response.json

{
  "success": true,
  "message": "Swaps found",
  "responseObject": {
    "swaps": [
      {
        "id": "1d9544ce-5692-4823-a7bc-9eef03f989dd",
        "networkId": 1399811149,
        "inTokenAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "inHumanAmount": 8.96158,
        "outTokenAddress": "GUbMJTArKAH8MxUhvBZw7NpXQcRD5jY6Sw4zdTQxdJNS",
        "outHumanAmount": 150650.56,
        "humanUsdAmountIn": 8.96158,
        "humanUsdAmountOut": 8.96158,
        "provider": "DFLOW",
        "createdAt": "2026-09-11T13:24:42.372Z"
      }
    ],
    "hasNextPage": true
  },
  "statusCode": 200
}

Rate limits and retry

Pro keys allow 5 requests per second. On a 429 response, wait for the Retry-After value before retrying.