Read the trades of one wallet

curl --request GET \
  --url https://api.fomoscan.sh/v3/wallets/{family}/{address}/trades \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.fomoscan.sh/v3/wallets/{family}/{address}/trades', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.fomoscan.sh/v3/wallets/{family}/{address}/trades"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "items": [
    {
      "kind": "trade",
      "id": "trd_01jbsta8h2ecsr8h2nank6cxvq",
      "canonical": {
        "network": "solana",
        "txHash": "5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW",
        "blockNumber": 371904117,
        "executedAt": "2026-11-01T08:57:12.000Z",
        "wallet": "wal_svm_9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
        "side": "buy",
        "token": "tok_solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
        "quantity": {
          "value": "412500000000",
          "decimals": 5,
          "currency": "tok_solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"
        },
        "quoteToken": "tok_solana_So11111111111111111111111111111111111111112",
        "quoteQuantity": {
          "value": "326814220",
          "decimals": 9,
          "currency": "tok_solana_So11111111111111111111111111111111111111112"
        },
        "platform": "fomo",
        "verification": "chain",
        "owner": null
      },
      "sources": {}
    },
    {
      "kind": "trade",
      "id": "trd_01jbstacskeh28anb6csvqf248",
      "canonical": {
        "network": "solana",
        "txHash": "3nTq8bVf9Lw2Hk7Yd4Rx6Cm1Pz5Js8Ga2Ue9Wo4Bt7Nc3Fy6Qh1Dk5Mv8Xr2Lp9Sg4Ja7Ze3Tb6Wn1Ku5Yc8Hf2Vd",
        "blockNumber": 371903650,
        "executedAt": "2026-11-01T08:54:03.000Z",
        "wallet": "wal_svm_9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
        "side": "sell",
        "token": "tok_solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
        "quantity": {
          "value": "150000000000",
          "decimals": 5,
          "currency": "tok_solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"
        },
        "quoteToken": "tok_solana_So11111111111111111111111111111111111111112",
        "quoteQuantity": {
          "value": "121480930",
          "decimals": 9,
          "currency": "tok_solana_So11111111111111111111111111111111111111112"
        },
        "platform": "fomo",
        "verification": "chain",
        "owner": null
      },
      "sources": {}
    }
  ],
  "hasMore": true,
  "nextCursor": "c_eyJxIjoiazNKOXhRMm1aN2FCIiwidiI6eyJzIjoiMjAyNi0xMS0wMVQwODo0MTowMi45MTdaIiwiaSI6IjAxOTJmM2E1LTIyMjItNzMzMy04NDQ0LTU1NTU2NjY2Nzc3NyJ9fQ"
}

{
  "error": {
    "type": "invalid_request",
    "code": "INVALID_ARGUMENT",
    "message": "<string>",
    "requestId": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request",
    "code": "INVALID_ARGUMENT",
    "message": "<string>",
    "requestId": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request",
    "code": "INVALID_ARGUMENT",
    "message": "<string>",
    "requestId": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request",
    "code": "INVALID_ARGUMENT",
    "message": "<string>",
    "requestId": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request",
    "code": "INVALID_ARGUMENT",
    "message": "<string>",
    "requestId": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request",
    "code": "INVALID_ARGUMENT",
    "message": "<string>",
    "requestId": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request",
    "code": "INVALID_ARGUMENT",
    "message": "<string>",
    "requestId": "<string>"
  }
}

Trades

Read the trades of one wallet

The trades of one wallet, mapped to a trader or not, newest first. owner is null: GET /v3/wallets/{family}/{address} names the owners.

network and token narrow the list.
A wallet without trades, or one we never saw, answers 200 with an empty page.
Order as in GET /v3/trades. Paged with cursor and limit (default 20, maximum 100). Follow nextCursor to read older rows.

Price

200 credits per started 20 rows of limit, on every call. A short or empty page costs the same as a full one.

Answer	Credits	Reveals
`limit` 1.	200	0
`limit` 20 (the default).	200	0
`limit` 50.	600	0
`limit` 100 (the maximum).	1,000	0

Limits

2,000 requests per minute from one address on this operation, beside the per-minute limit of the key.
A key with less than 200 credits left gets 402 QUOTA_EXCEEDED before any work.

GET

wallets

{family}

{address}

trades

Read the trades of one wallet

curl --request GET \
  --url https://api.fomoscan.sh/v3/wallets/{family}/{address}/trades \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.fomoscan.sh/v3/wallets/{family}/{address}/trades', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.fomoscan.sh/v3/wallets/{family}/{address}/trades"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "items": [
    {
      "kind": "trade",
      "id": "trd_01jbsta8h2ecsr8h2nank6cxvq",
      "canonical": {
        "network": "solana",
        "txHash": "5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW",
        "blockNumber": 371904117,
        "executedAt": "2026-11-01T08:57:12.000Z",
        "wallet": "wal_svm_9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
        "side": "buy",
        "token": "tok_solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
        "quantity": {
          "value": "412500000000",
          "decimals": 5,
          "currency": "tok_solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"
        },
        "quoteToken": "tok_solana_So11111111111111111111111111111111111111112",
        "quoteQuantity": {
          "value": "326814220",
          "decimals": 9,
          "currency": "tok_solana_So11111111111111111111111111111111111111112"
        },
        "platform": "fomo",
        "verification": "chain",
        "owner": null
      },
      "sources": {}
    },
    {
      "kind": "trade",
      "id": "trd_01jbstacskeh28anb6csvqf248",
      "canonical": {
        "network": "solana",
        "txHash": "3nTq8bVf9Lw2Hk7Yd4Rx6Cm1Pz5Js8Ga2Ue9Wo4Bt7Nc3Fy6Qh1Dk5Mv8Xr2Lp9Sg4Ja7Ze3Tb6Wn1Ku5Yc8Hf2Vd",
        "blockNumber": 371903650,
        "executedAt": "2026-11-01T08:54:03.000Z",
        "wallet": "wal_svm_9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
        "side": "sell",
        "token": "tok_solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
        "quantity": {
          "value": "150000000000",
          "decimals": 5,
          "currency": "tok_solana_DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"
        },
        "quoteToken": "tok_solana_So11111111111111111111111111111111111111112",
        "quoteQuantity": {
          "value": "121480930",
          "decimals": 9,
          "currency": "tok_solana_So11111111111111111111111111111111111111112"
        },
        "platform": "fomo",
        "verification": "chain",
        "owner": null
      },
      "sources": {}
    }
  ],
  "hasMore": true,
  "nextCursor": "c_eyJxIjoiazNKOXhRMm1aN2FCIiwidiI6eyJzIjoiMjAyNi0xMS0wMVQwODo0MTowMi45MTdaIiwiaSI6IjAxOTJmM2E1LTIyMjItNzMzMy04NDQ0LTU1NTU2NjY2Nzc3NyJ9fQ"
}

{
  "error": {
    "type": "invalid_request",
    "code": "INVALID_ARGUMENT",
    "message": "<string>",
    "requestId": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request",
    "code": "INVALID_ARGUMENT",
    "message": "<string>",
    "requestId": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request",
    "code": "INVALID_ARGUMENT",
    "message": "<string>",
    "requestId": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request",
    "code": "INVALID_ARGUMENT",
    "message": "<string>",
    "requestId": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request",
    "code": "INVALID_ARGUMENT",
    "message": "<string>",
    "requestId": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request",
    "code": "INVALID_ARGUMENT",
    "message": "<string>",
    "requestId": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request",
    "code": "INVALID_ARGUMENT",
    "message": "<string>",
    "requestId": "<string>"
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

family

enum<string>

required

The address family: svm for Solana, evm for EVM networks.

Available options:

svm,

evm

address

string

required

The wallet address. An EVM address matches in any letter case.

Required string length: 1 - 128

Query Parameters

network

enum<string>

Only trades on this network. Leave it out for every network.

Available options:

solana,

ethereum,

base,

bsc,

arbitrum,

optimism,

polygon,

robinhood,

hyperevm,

monad,

arc,

xlayer,

ink,

hyperliquid

token

string

Only trades in this token: tok_<network>_<address>.

Required string length: 5 - 200

cursor

string

The nextCursor of the previous page, sent back as it came. Leave it out for the first page. A cursor belongs to the query that produced it: sent with other parameters it answers 400 INVALID_ARGUMENT.

Required string length: 3 - 1024

limit

integer

default:20

Rows per page, 1 to 100. 20 when left out.

Required range: 1 <= x <= 100

Response

One page of a list. Pass nextCursor back as cursor for the next page.

items

object[]

required

The rows of this page, in the order the operation states.

Show child attributes

hasMore

boolean

required

true when another page follows this one.

nextCursor

string | null

required

The cursor of the next page (c_…), or null on the last page. Treat it as opaque: send it back as cursor, never parse or build it.

Overview

Endpoints

Read the trades of one wallet

Price

Limits

Authorizations

Path Parameters

Query Parameters

Response