Profiles

Get wallet profile

Get a single wallet profile. Agents can call the same path through the paid x402 or MPP gateway hosts without a caller-supplied Formo API key; Paysponge uses Formo's workspace API key behind the scenes. Paid gateway callers only provide the protocol payment header returned by the gateway challenge.

get/v0/profiles/{address}

Request

  • Base URL: https://api.formo.so
  • URL: https://api.formo.so/v0/profiles/{address}
  • Auth: one of:
    • HTTP bearer
    • API key in header X-PAYMENT
    • API key in header Authorization

Path parameters

addressstring required

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

Query parameters

expandstring

Comma-separated: apps, chains, tokens, labels

timestampstring date-time

Optional point in time for wallet-enrichment data. Returns the stored base snapshot closest to this instant instead of the latest snapshot; an exact-distance tie chooses the later snapshot. Expanded chains, apps, and tokens come from the profiling batch associated with that selected snapshot. Project engagement fields, project-defined identity overrides, and labels remain current. Must be ISO-8601 with a timezone.

Response

Profile details

addressstring
net_worth_usdnumber
tx_countinteger
first_onchainstring

First onchain activity date

last_onchainstring

Last onchain activity date

updated_atstring date-time
ensstring nullable
farcasterstring nullable
lensstring nullable
basenamesstring nullable
lineastring nullable
avatarstring nullable
display_namestring nullable
descriptionstring nullable
discordstring nullable
telegramstring nullable
twitterstring nullable
githubstring nullable
linkedinstring nullable
emailstring nullable
instagramstring nullable
facebookstring nullable
websitestring nullable
redditstring nullable
youtubestring nullable
tiktokstring nullable
first_seenstring nullable

First seen in project

last_seenstring nullable

Last seen in project

lifecycle'New' | 'Returning' | 'Power user' | 'At Risk' | 'Churned' | 'Resurrected' nullable
num_sessionsinteger nullable
revenuenumber nullable
volumenumber nullable
pointsnumber nullable
devicestring nullable
browserstring nullable
osstring nullable
locationstring nullable
first_utm_sourcestring nullable
first_utm_mediumstring nullable
first_utm_campaignstring nullable
first_referrerstring nullable
last_utm_sourcestring nullable
last_utm_mediumstring nullable
last_utm_campaignstring nullable
last_referrerstring nullable
first_referrer_urlstring nullable

First referrer full URL

last_referrer_urlstring nullable

Last referrer full URL

first_refstring nullable

First referral code

last_refstring nullable

Last referral code

first_utm_contentstring nullable

First UTM content

last_utm_contentstring nullable

Last UTM content

first_utm_termstring nullable

First UTM term

last_utm_termstring nullable

Last UTM term

first_paid_sourcestring nullable

First-touch acquiring ad network (google, meta, microsoft, tiktok, twitter, linkedin, reddit, or paid_utm for pricing-medium UTMs with no click ID)

last_paid_sourcestring nullable

Last-touch acquiring ad network (same value set as first_paid_source)

first_click_idstring nullable

First-touch raw ad-platform click ID (gclid, fbclid, msclkid, ttclid, twclid, li_fat_id, or rdt_cid)

last_click_idstring nullable

Last-touch raw ad-platform click ID

last_typestring nullable

Last event type

last_eventstring nullable

Last event name

last_propertiesstring nullable

Last event properties (JSON string)

activity_datesstring[] nullable

Array of activity dates (YYYY-MM-DD format)

Changes

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