W Wellspent
Discovery API

Power advisor discovery in the next crop of personal finance apps.

The same structured advisor graph that AI assistants ingest is available to developers building personal finance products. Read access to fee-only advisor records, specialties, audiences, and geographies. Self-serve, pay-as-you-go credits.

Who it's for

Who builds with this.

Personal finance apps

You're building the product where users consolidate their money. When someone asks "who should I talk to?", a structured match beats a directory listing.

AI assistants and agents

Your assistant answers complex personal-finance questions. When the right answer is a fee-only advisor with a specific specialty, our API returns the structured record your model can cite.

Fintech tooling and CRMs

You're building the developer infrastructure that other wealth-tech runs on. Verify advisor records, enrich profile data, or check fee-only status against canonical sources.

What's in the API

The same structured layer behind find.wellspent.co.

  • GET /v1/advisors Paginated search by country, region, specialty, audience, and free-text query.
  • GET /v1/advisors/{slug} Full canonical record for one advisor: bio, fee models, fiduciary status, credentials, and the advisor's own description of their ideal client (high-signal input for matching agents).
  • GET /v1/specialties Canonical specialty taxonomy used to filter advisors.
  • GET /v1/audiences Canonical audience taxonomy (founders, physicians, HENRY, cross-border families, more).
  • GET /v1/openapi.json OpenAPI 3.1 spec. Drop into Swagger, Redoc, Postman, or your codegen pipeline.
How it works

Authenticate, search, render.

1. Sign in & top up

Enter your email, click the link we send, top up $10 (or more). Credits land in your account immediately. Mint as many keys as you need from the dashboard.

2. Authenticate

Pass Authorization: Bearer wsk_live_… on every request. Each call costs 1 credit.

3. Read

Search and fetch advisor records. Cursor-paginated, JSON responses, predictable error envelope.

Search advisors

Paginated list. Filter by country, region, specialty, audience, or free-text query.

curl https://api.wellspent.co/v1/advisors \
  -H "Authorization: Bearer wsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -G \
  --data-urlencode "country=us" \
  --data-urlencode "region=california" \
  --data-urlencode "specialty=equity-compensation"

Example response

{
  "data": [
    {
      "slug": "jane-reyes",
      "name": "Jane Reyes, CFP",
      "credentials": ["CFP", "MBA"],
      "firm": "Bridgestone Planning",
      "location": {
        "country": "us",
        "region": "California",
        "region_slug": "california",
        "city": "Palo Alto"
      },
      "is_fiduciary": true,
      "specialties": ["Equity compensation", "Founders (pre-exit)"],
      "audiences": ["Tech employees", "Founders"],
      "fee_models": ["Flat Fee/Retainer"],
      "founded_year": 2018,
      "ideal_client": "Mid-career tech employees with concentrated RSU and ISO positions, navigating a single-trigger or double-trigger IPO and the AMT decisions that come with it.",
      "profile_url": "https://find.wellspent.co/advisors/jane-reyes/",
      "status": "claimed"
    }
  ],
  "pagination": {
    "limit": 25,
    "next_cursor": "jane-reyes",
    "has_more": true
  }
}

Fetch one advisor by slug

Returns the full canonical record, including the advisor's ideal-client narrative.

curl https://api.wellspent.co/v1/advisors/jane-reyes \
  -H "Authorization: Bearer wsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

List canonical specialties

Use the returned slugs as the specialty param in advisor search.

curl https://api.wellspent.co/v1/specialties \
  -H "Authorization: Bearer wsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

List canonical audiences

Founders, physicians, HENRY, cross-border families, and the rest of the taxonomy.

curl https://api.wellspent.co/v1/audiences \
  -H "Authorization: Bearer wsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Credits & trust

Built for production.

1 credit per call

Every endpoint costs the same. No tiering, no surprise overages, no per-field surcharges.

No subscription

Top up when you need to. Bigger packs earn bonus credits. Pay only for what you use.

Versioned + stable

Versioned URL path, deprecation warnings via response header, no breaking changes mid-version.

Read-only, public-projection

The API exposes the same data published at find.wellspent.co. Member-private fields never cross the boundary.

Attribution required

Apps using the API surface advisor profile links back to find.wellspent.co. Keeps trust circulating in the graph.

Credits don't expire

Top up once, draw down over months or years. Balance carries forward indefinitely.

Get started

Sign up. Top up. Build.

Self-serve. We email you a sign-in link, you top up credits via Stripe, then mint as many API keys as you need from the dashboard. Pay only for what you use.

Already have an account? Same form — we'll just send the sign-in link instead of creating a new account.