Profiles

Search wallet profiles

get/v0/profiles

Request

  • Base URL: https://api.formo.so
  • URL: https://api.formo.so/v0/profiles
  • Auth: HTTP bearer

Query parameters

addressstring

Filter by wallet address. Accepts an EVM (0x...) or Solana address, or an ENS name (e.g. vitalik.eth) which is resolved to an address.

expandstring

Comma-separated: apps, chains, tokens, labels

timestampstring date-time

Optional point in time for wallet-enrichment data. Requires the address query parameter; unbounded historical collection scans are rejected. Returns the wallet's stored base snapshot closest to this instant instead of its latest snapshot; an exact-distance tie chooses the later snapshot. Expanded chains, apps, and tokens come from the selected snapshot's profiling batch. Project engagement fields, project-defined identity overrides, and labels remain current. Must be ISO-8601 with a timezone.

order_by'net_worth_usd' | 'tx_count' | 'first_onchain' | 'last_onchain' | 'updated_at' | 'first_seen' | 'last_seen' | 'num_sessions' | 'revenue' | 'volume' | 'points'

Sort field

order_dir'asc' | 'desc'

Sort direction

pageinteger

1-indexed page number (default 1).

sizeinteger

Page size (default 100, max 1000).

Request body

logic'and' | 'or'

Response

Paginated wallet profile search results.

pageinteger required

1-indexed page number echoed from the request.

sizeinteger required

Page size echoed from the request.

totalinteger required

Total row count across all pages.

has_moreboolean required

True when more pages remain (page * size < total).

Changes

No recorded changes to this operation across all 1 revision of this API.