curl --request GET \
--url https://api.fomoscan.sh/v3/wallets/{family}/{address} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fomoscan.sh/v3/wallets/{family}/{address}', 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}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"kind": "wallet",
"id": "wal_svm_9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
"canonical": {
"family": "svm",
"address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
"firstSeenAt": "2025-03-14T16:20:05.412Z",
"lastSeenAt": "2026-11-01T08:57:12.000Z",
"labels": [],
"owners": [
{
"trader": "tdr_01jbst8pvcfp79y0938nkrkayd",
"tier": "proven",
"links": [
{
"platform": "fomo",
"method": "svm_dual_proof",
"firstVerifiedAt": "2025-06-02T10:41:17.006Z",
"lastVerifiedAt": "2026-10-29T03:12:55.810Z"
}
]
}
]
},
"sources": {}
}{
"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>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}Read one wallet and who owns it
One wallet and the traders linked to it as owners. Each owner carries a tier, how sure we are, and the links behind it.
- An EVM address matches in any letter case and comes back lowercase.
- Owners: strongest tier first, then the earliest
firstVerifiedAt, then trader id. - A tier is capped at
weakwhen two or more traders hold the wallet, or the wallet carries acustodialorexchangelabel. - A wallet we know without an owner answers 200 with an empty
ownerslist. - A link read from the wallet a platform profile shows never counts; every other active link does, at its tier.
Price
The price depends on the answer. The Reveals column says when a reveal is taken.
| Answer | Credits | Reveals |
|---|---|---|
An owner holds a tier other than account. | 30,000 | 1 |
Every owner holds the tier account. | 10 | 0 |
| The wallet has no owner (200 with the envelope), or we never saw it (404). | 200 | 0 |
Reveals count against a key with a monthly reveal cap. When the answer needs more reveals than the key has left, the call is refused before any credit is taken: 402 REVEAL_LIMIT_REACHED, or 403 PERMISSION_DENIED for a key on a free plan without reveals.
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 10 credits left gets 402
QUOTA_EXCEEDEDbefore any work.
curl --request GET \
--url https://api.fomoscan.sh/v3/wallets/{family}/{address} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fomoscan.sh/v3/wallets/{family}/{address}', 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}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"kind": "wallet",
"id": "wal_svm_9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
"canonical": {
"family": "svm",
"address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
"firstSeenAt": "2025-03-14T16:20:05.412Z",
"lastSeenAt": "2026-11-01T08:57:12.000Z",
"labels": [],
"owners": [
{
"trader": "tdr_01jbst8pvcfp79y0938nkrkayd",
"tier": "proven",
"links": [
{
"platform": "fomo",
"method": "svm_dual_proof",
"firstVerifiedAt": "2025-06-02T10:41:17.006Z",
"lastVerifiedAt": "2026-10-29T03:12:55.810Z"
}
]
}
]
},
"sources": {}
}{
"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>"
}
}{
"error": {
"type": "invalid_request",
"code": "INVALID_ARGUMENT",
"message": "<string>",
"requestId": "<string>"
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The address family: svm for Solana, evm for EVM networks.
svm, evm The wallet address. An EVM address matches in any letter case.
1 - 128Response
OK
A wallet address and the traders linked to it as owners, each with a tier.
The kind of object, wallet here, and the only field to switch on. Skip objects whose kind you do not know.
"wallet"Our id of the object, wal_<family>_<address>, family svm or evm. Store it: it stays the same across calls and never holds a platform's own id.
Fields that mean the same on every platform.
Show child attributes
Show child attributes
Capability blocks keyed by platform. A platform key is absent when the object has no side on that platform. A block is absent when the platform cannot provide it (GET /v3/capabilities lists which can) or we hold no reading of it yet. A field is null when the platform left it empty at observedAt or never fills it (unfilled in GET /v3/capabilities). Skip platform keys and blocks you do not know.
Show child attributes
Show child attributes