Purple Flea for LangFlow

Overview

Visual AI Pipelines, Now With Crypto

LangFlow is a visual GUI built on top of LangChain that lets you assemble AI pipelines by dragging and connecting nodes on a canvas. Every LangChain tool, chain, and memory module becomes a visual block you can wire together without writing code. Purple Flea extends this model by contributing a set of financial tool nodes — each backed by a live, production API — that your LangFlow agents can invoke at runtime.

🎨

Drag-and-Drop Tool Nodes

Purple Flea tools appear as first-class nodes in the LangFlow canvas. Drop a "CryptoWallet" node, wire it to your agent, and the agent can call getBalance, send, and receive on any supported chain without touching a line of code.

🔗

LangChain Tool Protocol

Because LangFlow runs on LangChain under the hood, any LangChain tool is natively compatible. Purple Flea ships a purpleflea-langchain package that exports ready-made tool classes — LangFlow auto-discovers these when you install the package into your LangFlow environment.

⚡

Zero-Infrastructure Setup

There is no sidecar to run, no database to provision, and no key management system to operate. Every cryptographic operation — key derivation, signing, broadcasting — happens server-side on Purple Flea's infrastructure. Your LangFlow flow only needs one thing: your API key.

🔒

Headless by Design

LangFlow flows run unattended. Purple Flea was engineered for exactly this use-case: no OAuth popups, no email magic links, no browser wallets. Authentication is a single static API key passed through LangFlow's built-in credential store.

📊

Real-Time Market Data

Wire a "HyperliquidMarket" node to your LLM reasoning chain and give your agent the ability to fetch live prices across 275+ perpetual markets, read order book depth, and monitor funding rates — all from within the same visual canvas.

🎰

Provably Fair Casino Node

The casino tool node exposes roll, flip, and spin with on-chain verifiable randomness. Build game-theoretic agent strategies, research house-edge dynamics, or create entertainment flows — entirely in the canvas.

Installation

Get Purple Flea into LangFlow in 4 Steps

Whether you run LangFlow locally, in Docker, or on LangFlow Cloud, the integration path is the same.

Install the Purple Flea LangChain package

In your LangFlow environment (or Docker container), install the package so LangFlow can discover the tool classes at startup.

pip install purpleflea-langchain

Add your API key as a LangFlow credential

In the LangFlow UI, go to Settings → Global Variables and add a new secret named PURPLE_FLEA_API_KEY. Paste in your Purple Flea key. LangFlow injects it as an environment variable at flow runtime.

Open the tool palette and search "Purple Flea"

After restarting LangFlow, open any flow and search the left-hand component palette for "Purple Flea". You will see nodes for Wallet, Trading, Casino, Domains, Escrow, and Faucet. Drag the ones you need onto the canvas.

Wire the tool nodes to your agent

Connect the output ports of your Purple Flea nodes to the tools input of an Agent node. LangFlow will pass them to the underlying LangChain agent executor, making each tool callable by the LLM during reasoning.

Integration Detail

LangFlow Custom Tool Setup

For flows that use LangFlow's native "Custom Tool" node rather than the pre-built package, configure the node as follows. The endpoint is the Purple Flea REST API; LangFlow will call it with JSON and receive JSON back.

Custom Tool Node Config

# LangFlow Custom Tool settings
API Endpoint:  https://purpleflea.com/api/v1
API Key Field: X-PF-API-Key
Key Value:     {{PURPLE_FLEA_API_KEY}}
Content-Type: application/json
Method:       POST
Tool Name:    purple_flea
        

JSON Tool Schema for LangFlow

{
  "name": "purple_flea_wallet",
  "description": "Crypto wallet ops",
  "parameters": {
    "type": "object",
    "properties": {
      "action": {
        "type": "string",
        "enum": ["balance", "send",
                  "receive", "history"]
      },
      "chain": { "type": "string" },
      "amount": { "type": "number" },
      "to": { "type": "string" }
    },
    "required": ["action"]
  }
}
        

Architecture

How the Flow Executes

A sample LangFlow pipeline with Purple Flea tools. Each box is a drag-and-drop node on the LangFlow canvas.

  ┌─────────────────────────────────────────────────────────────────────────────┐
  │                        LangFlow Canvas                                      │
  │                                                                             │
  │  ┌──────────────────┐     ┌───────────────────┐     ┌────────────────────┐  │
  │  │  User Message    │────▶│  OpenAI GPT-4o    │────▶│  Agent Executor    │  │
  │  │  (Input Node)    │     │  (LLM Node)       │     │  (ReAct Agent)     │  │
  │  └──────────────────┘     └───────────────────┘     └────────┬───────────┘  │
  │                                                              │               │
  │                              tools ◀────────────────────────┘               │
  │                                │                                             │
  │              ┌─────────────────┼─────────────────────┐                      │
  │              ▼                 ▼                     ▼                      │
  │  ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐             │
  │  │  PF Wallet Tool  │ │  PF Trading Tool │ │  PF Casino Tool  │             │
  │  │  (PurpleFlea)    │ │  (PurpleFlea)    │ │  (PurpleFlea)    │             │
  │  └────────┬─────────┘ └────────┬─────────┘ └────────┬─────────┘             │
  │           │                   │                     │                       │
  │           └───────────────────┴─────────────────────┘                       │
  │                                       │                                     │
  │                                       ▼                                     │
  │                         ┌─────────────────────────┐                        │
  │                         │  Purple Flea REST API    │                        │
  │                         │  purpleflea.com/api/v1   │                        │
  │                         └─────────────────────────┘                        │
  └─────────────────────────────────────────────────────────────────────────────┘

Available Tools

Every Tool Available in LangFlow

All six Purple Flea services are exposed as individual LangFlow nodes. Mix and match them in your canvas.

Wallet — BTC, ETH, SOL, XMR, TRX, DOGE, TON Hyperliquid Trading — 275+ perpetual markets Casino — dice, flip, slots, roulette (provably fair) Domains — 500+ TLDs, ENS, .sol, .crypto, Handshake Escrow — trustless agent-to-agent payments, 1% fee Faucet — free funds for new agents to start getBalance(chain) sendFunds(to, amount, chain) placeOrder(market, side, size, price) rollDice(bet, amount) registerDomain(name, tld, years) createEscrow(counterparty, amount, terms)

Each tool node in LangFlow includes a description string that the LLM uses to decide when to invoke it. The descriptions are carefully written so that a ReAct-style agent can route correctly between wallet operations, trading actions, and casino plays without ambiguity. The agent does not need explicit routing logic — the tool descriptions do the work.

Referral Program

Earn While Your Flows Earn

Every Purple Flea API key has an associated referral code. Share it with other LangFlow builders and earn a percentage of every fee their agents generate — forever, with no cap.

20%

Casino referral

10%

Wallet fees

10%

Trading fees

15%

Escrow fees

Referral income accrues to your Purple Flea wallet in real time. You can withdraw it, reinvest it in casino plays, or use it to fund trading positions — all without leaving the ecosystem. LangFlow builders who share their flows publicly often embed their referral code in the flow's README, generating passive income from community forks.