Liquid Agent Leads API

The Leads API from Liquid Agent — 6 operation(s) for leads.

GitHub OpenAPI

Operations 6

GET /v1/leads Liquid Leads: coverage, parameters, grades and pricing (free) #
GET /v1/leads/categories Which business categories exist in a place, with counts (free) #
GET /v1/leads/count How many leads match, by email grade, and the exact price of the next page… #
GET /v1/leads/search Local business leads with checked emails, contact names and buying signals #
GET /v1/leads/lookup Reverse phone or website lookup: the US local business behind a phone number or… #
GET /v1/leads/tech Website technology lookup: platform, booking tool, payment system and socials… #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/liquidagent-ai:liquidagent-ai-leads-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

liquidagent-ai-leads-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: 'Liquid Agent: Money Tools for AI Agents Leads API'
  version: 1.0.0
  description: 'x402 money tools for AI agents: verified local business leads (6.0M businesses in 42 US states, websites proven by the business''s own phone, graded emails, buying signals, $0.03 a lead), a one-signature USDC bridge from Base to 16 chains, the live Polymarket price to beat (BTC, ETH, SOL, XRP on 5m and 15m), a tokenized US stock basket from $1, and gas paid in USDC, plus free USDC and x402 debugging tools and a remote MCP server (31 tools). No account, no API key. Part of Liquid Agent, the money layer for humans and their agents: one USDC balance for yield, payments, and tokenized stocks, for people through the app and for agents over x402. This API lets you buy and invest in tokenized US stocks on-chain from $1: NVIDIA, Apple, Meta and Alphabet. Mint your own vault holding a band-rebalanced stock basket, equal-weight or your custom portfolio, and rebalance or cash out any block. Self-priced NAV (no oracle), in-kind exit, no brokerage account, no project token. Reads are free; transactions return unsigned calldata the agent signs and broadcasts with its own gas.'
  contact:
    name: Liquid Agent
    url: https://api.liquidagent.ai
    email: liquidagentai@gmail.com
  x-guidance: 'Liquid Agent is the money layer for humans and their agents: one USDC balance for yield, payments, and tokenized stocks, for people through the app and for agents over x402. This API is the agent-facing tokenized-stock index. It lets an agent mint its OWN vault holding a band-rebalanced basket of Coinbase''s tokenized NVDA/META/AAPL/GOOGL on Base (eip155:8453). Reads are FREE; every POST returns an UNSIGNED {to,data,value,chainId} that YOU sign and broadcast with your own gas (the server never signs). Amounts are USDC-6 (2000000 = $2). weightsBps are basis points summing to 10000. FLOW: 1) GET /v1/basket — discover constituents + live prices + fees. 2) GET /v1/quote?usdc=<amount6> — preview shares + mint fee. 3) POST /v1/create-vault — unsigned createVault(); sign+broadcast (you become the sole strategist, the protocol Safe owns it for fees). 4) GET /v1/balance/<your-address> — your new vault address. 5) POST /v1/set-weights {vault,weightsBps:[4]} — optional custom allocation. 6) POST /v1/buy {vault,usdc,permit:true,owner} — EIP-712 permit to sign off-chain, then re-POST with permit:{deadline,signature} for ONE unsigned depositWithPermit tx (no approve; omit permit for legacy approve+deposit). 7) POST /v1/rebalance {vault} — move to your target. 8) GET /v1/vault/<vault> — NAV + weights (self-priced TWAP, no oracle). 9) POST /v1/redeem {vault,shares,inKind?} — exit to USDC or raw tokens (un-trappable, any block). REUSE: create-vault is a ONE-TIME step. To add funds later do NOT create again — GET /v1/balance/<you>, take vaults[0].vault, and POST /v1/buy into that same vault (each buy mints more shares). create-vault always makes a brand-new separate vault. Contracts: factory 0x1B205660780CbC57849019Df2BA64B719b00AEA8, USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913. Broadcast over any Base RPC (e.g. an x402 RPC); deposits swap precompile tokens so pass an explicit gas limit ~3,000,000.'
servers:
- url: https://api.liquidagent.ai
tags:
- name: Leads
paths:
  /v1/leads:
    get:
      operationId: getV1Leads
      summary: 'Liquid Leads: coverage, parameters, grades and pricing (free)'
      tags:
      - Leads
      security:
      - siwx: []
      description: 'Free. Local business leads by category and place for B2B prospecting and cold outreach: a lead list of US small businesses (dentists, plumbers, salons, contractors...) with verified emails (graded A/B/C), a contact name when the email shows one, phone, a website proven by the business''s own phone number, socials and buying signals (no website, online booking tool, payment system, hiring).'
      responses:
        '200':
          description: service info
          content:
            application/json:
              schema:
                type: object
  /v1/leads/categories:
    get:
      operationId: getV1LeadsCategories
      summary: Which business categories exist in a place, with counts (free)
      tags:
      - Leads
      security:
      - siwx: []
      parameters:
      - name: state
        in: query
        required: false
        schema:
          type: string
          example: ga
        description: 2-letter state
      - name: city
        in: query
        required: false
        schema:
          type: string
          example: Atlanta
        description: City
      - name: county
        in: query
        required: false
        schema:
          type: string
          example: Gwinnett
        description: County
      responses:
        '200':
          description: categories
          content:
            application/json:
              schema:
                type: object
  /v1/leads/count:
    get:
      operationId: getV1LeadsCount
      summary: How many leads match, by email grade, and the exact price of the next page…
      tags:
      - Leads
      security:
      - siwx: []
      description: Free. Same parameters as /v1/leads/search.
      parameters:
      - name: category
        in: query
        required: true
        schema:
          type: string
          maxLength: 60
          example: dentist
        description: 'Business type in plain words: dentist, plumber, hvac, roofing, hair salon, law firm, med spa, restaurant.'
      - name: city
        in: query
        required: false
        schema:
          type: string
          example: Atlanta
        description: City, e.g. Atlanta, Savannah, Macon. Or county, zip, or near.
      - name: county
        in: query
        required: false
        schema:
          type: string
        description: County, e.g. Gwinnett, Chatham.
      - name: sample
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
        description: 1 = 3 free leads (3 a day) to judge quality.
      - name: zip
        in: query
        required: false
        schema:
          type: string
          example: '30309'
        description: 5-digit ZIP (a prefix works).
      - name: near
        in: query
        required: false
        schema:
          type: string
          example: 33.7812,-84.3831
        description: lat,lng to search around (with radiusKm).
      - name: radiusKm
        in: query
        required: false
        schema:
          type: number
          example: 5
        description: Radius for near, 0.5-50 (default 5).
      - name: minGrade
        in: query
        required: false
        schema:
          type: string
          enum:
          - A
          - B
          - C
        description: 'Email grade floor: A, B or C (default C).'
      - name: email
        in: query
        required: false
        schema:
          type: string
          enum:
          - required
          - any
          - none
        description: required (default), any, or none.
      - name: website
        in: query
        required: false
        schema:
          type: string
          enum:
          - any
          - has
          - none
          - dead
          - needs
        description: any, has, none, dead, or needs (no working website).
      - name: booking
        in: query
        required: false
        schema:
          type: string
        description: 'Online booking tool: yes, none, vagaro, square_appointments, calendly, booksy, mindbody, acuity, opentable, housecall_pro, jobber, servicetitan, zocdoc.'
      - name: payments
        in: query
        required: false
        schema:
          type: string
        description: 'Payment system seen on the site: yes, none, square, toast, clover, stripe, paypal.'
      - name: platform
        in: query
        required: false
        schema:
          type: string
        description: 'Website platform: wordpress, wix, squarespace, shopify, godaddy, webflow, none.'
      - name: hiring
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
        description: 1 = their site says they are hiring.
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 1000
          example: 3
        description: How many leads, 1-1000 (default 3); $0.03 per lead.
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
        description: Skip this many, for the next page.
      - name: format
        in: query
        required: false
        schema:
          type: string
          enum:
          - json
          - csv
        description: json (default) or csv.
      responses:
        '200':
          description: counts
          content:
            application/json:
              schema:
                type: object
  /v1/leads/search:
    get:
      operationId: getV1LeadsSearch
      summary: Local business leads with checked emails, contact names and buying signals
      tags:
      - Leads
      description: 'PAID: USDC, $0.03 per lead, flat (with or without an email); 1 to 1000 leads per call (default 3 = $0.09); free first: sample=1 returns 3 leads; the 402 quotes the exact total; empty answers are free. x402 exact scheme, EIP-3009 USDC on Base eip155:8453 or Arc eip155:5042. Local business leads by category and place for B2B prospecting and cold outreach: a lead list of US small businesses (dentists, plumbers, salons, contractors...) with verified emails (graded A/B/C), a contact name when the email shows one, phone, a website proven by the business''s own phone number, socials and buying signals (no website, online booking tool, payment system, hiring).'
      security:
      - x402: []
      parameters:
      - name: category
        in: query
        required: true
        schema:
          type: string
          maxLength: 60
          example: dentist
        description: 'Business type in plain words: dentist, plumber, hvac, roofing, hair salon, law firm, med spa, restaurant.'
      - name: city
        in: query
        required: false
        schema:
          type: string
          example: Atlanta
        description: City, e.g. Atlanta, Savannah, Macon. Or county, zip, or near.
      - name: county
        in: query
        required: false
        schema:
          type: string
        description: County, e.g. Gwinnett, Chatham.
      - name: sample
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
        description: 1 = 3 free leads (3 a day) to judge quality.
      - name: zip
        in: query
        required: false
        schema:
          type: string
          example: '30309'
        description: 5-digit ZIP (a prefix works).
      - name: near
        in: query
        required: false
        schema:
          type: string
          example: 33.7812,-84.3831
        description: lat,lng to search around (with radiusKm).
      - name: radiusKm
        in: query
        required: false
        schema:
          type: number
          example: 5
        description: Radius for near, 0.5-50 (default 5).
      - name: minGrade
        in: query
        required: false
        schema:
          type: string
          enum:
          - A
          - B
          - C
        description: 'Email grade floor: A, B or C (default C).'
      - name: email
        in: query
        required: false
        schema:
          type: string
          enum:
          - required
          - any
          - none
        description: required (default), any, or none.
      - name: website
        in: query
        required: false
        schema:
          type: string
          enum:
          - any
          - has
          - none
          - dead
          - needs
        description: any, has, none, dead, or needs (no working website).
      - name: booking
        in: query
        required: false
        schema:
          type: string
        description: 'Online booking tool: yes, none, vagaro, square_appointments, calendly, booksy, mindbody, acuity, opentable, housecall_pro, jobber, servicetitan, zocdoc.'
      - name: payments
        in: query
        required: false
        schema:
          type: string
        description: 'Payment system seen on the site: yes, none, square, toast, clover, stripe, paypal.'
      - name: platform
        in: query
        required: false
        schema:
          type: string
        description: 'Website platform: wordpress, wix, squarespace, shopify, godaddy, webflow, none.'
      - name: hiring
        in: query
        required: false
        schema:
          type: string
          enum:
          - '1'
        description: 1 = their site says they are hiring.
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 1000
          example: 3
        description: How many leads, 1-1000 (default 3); $0.03 per lead.
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
        description: Skip this many, for the next page.
      - name: format
        in: query
        required: false
        schema:
          type: string
          enum:
          - json
          - csv
        description: json (default) or csv.
      x-payment-info:
        protocols:
        - x402:
            scheme: exact
            network: eip155:8453
            asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
            payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
        - x402:
            scheme: exact
            network: eip155:5042
            asset: '0x3600000000000000000000000000000000000000'
            payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
        price:
          mode: dynamic
          currency: USD
          min: '0.03'
          max: '30.00'
          description: flat $0.03 per lead returned, with or without an email; default 3 leads = $0.09; sample=1 is free (3 leads); exact total in the 402
      responses:
        '200':
          description: leads (JSON, or CSV with format=csv)
          content:
            application/json:
              schema:
                type: object
            text/csv:
              schema:
                type: string
        '402':
          description: x402 payment required (the exact total for this query)
          content:
            application/json:
              schema:
                type: object
  /v1/leads/lookup:
    get:
      operationId: getV1LeadsLookup
      summary: 'Reverse phone or website lookup: the US local business behind a phone number or…'
      tags:
      - Leads
      description: 'PAID: $0.01 per lookup that finds a business, no match no charge. x402 exact scheme, EIP-3009 USDC on Base eip155:8453 or Arc eip155:5042. Reverse phone and website lookup for US local businesses: give a phone number or a website, get the business behind it (name, address, category, graded email, contact name, socials, buying signals). Websites only match when they carry the business''s own phone number.'
      security:
      - x402: []
      parameters:
      - name: phone
        in: query
        required: false
        schema:
          type: string
          example: '4043552001'
        description: 'A US phone number, any format: 4043552001, (404) 355-2001, +14043552001. Give phone or domain.'
      - name: domain
        in: query
        required: false
        schema:
          type: string
          example: atlantadentistrybydesign.com
        description: 'Or a website: example.com or https://www.example.com/contact.'
      x-payment-info:
        protocols:
        - x402:
            scheme: exact
            network: eip155:8453
            asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
            payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
        - x402:
            scheme: exact
            network: eip155:5042
            asset: '0x3600000000000000000000000000000000000000'
            payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
        price:
          mode: fixed
          currency: USD
          amount: '0.01'
      responses:
        '200':
          description: the match (found=false and no charge when nothing matches)
          content:
            application/json:
              schema:
                type: object
        '402':
          description: x402 payment required
          content:
            application/json:
              schema:
                type: object
  /v1/leads/tech:
    get:
      operationId: getV1LeadsTech
      summary: 'Website technology lookup: platform, booking tool, payment system and socials…'
      tags:
      - Leads
      description: 'PAID: $0.005 per lookup that finds a verified site, no match no charge. x402 exact scheme, EIP-3009 USDC on Base eip155:8453 or Arc eip155:5042. Website technology lookup (technographics) for US local businesses: give a website or phone number, get the site platform (WordPress, Wix, Squarespace, Shopify), online booking tool (Square Appointments, Vagaro, Calendly, Zocdoc), payment system (Square, Toast, Clover, Stripe), hiring and socials, read from the business''s own verified website.'
      security:
      - x402: []
      parameters:
      - name: phone
        in: query
        required: false
        schema:
          type: string
          example: '4043552001'
        description: 'A US phone number, any format: 4043552001, (404) 355-2001, +14043552001. Give phone or domain.'
      - name: domain
        in: query
        required: false
        schema:
          type: string
          example: atlantadentistrybydesign.com
        description: 'Or a website: example.com or https://www.example.com/contact.'
      x-payment-info:
        protocols:
        - x402:
            scheme: exact
            network: eip155:8453
            asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
            payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
        - x402:
            scheme: exact
            network: eip155:5042
            asset: '0x3600000000000000000000000000000000000000'
            payTo: '0x487b28A4FbbA8Cf46eb6E1d72e6959202Bb75e90'
        price:
          mode: fixed
          currency: USD
          amount: '0.005'
      responses:
        '200':
          description: the match (found=false and no charge when nothing matches)
          content:
            application/json:
              schema:
                type: object
        '402':
          description: x402 payment required
          content:
            application/json:
              schema:
                type: object
components:
  securitySchemes:
    siwx:
      type: apiKey
      in: header
      name: SIGN-IN-WITH-X
      description: Sign-In with X wallet identity (EIP-4361). Optional; no payment.
    x402:
      type: http
      scheme: x402
      description: Pay-per-call via x402 (exact scheme, EIP-3009 USDC on Base eip155:8453 or Polygon eip155:137). Sign a USDC authorization; no account, no key held by the server.
externalDocs:
  description: Open-source code examples (JavaScript/viem, Python/web3, curl) + README for the full create/buy/rebalance/exit flow.
  url: https://github.com/LiquidAgent/liquidagentx402
x-provenance:
  method: harvested
  publisher: Liquid Agent
  source: https://api.liquidagent.ai/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)