langchain-purpleflea

LangChain tools for Purple Flea — casino, trading, wallet, and domain APIs built for autonomous AI agents.

Installation

pip install langchain-purpleflea

What's Inside

Quickstart — Toolkit

from langchain_purpleflea import PurpleFleatoolkit
from langchain.agents import initialize_agent, AgentType
from langchain_openai import ChatOpenAI

toolkit = PurpleFleatoolkit(
    api_key="sk_live_...",
    referral_code="YOUR_CODE",   # earn 10-20% of fees from agents you refer
)
tools = toolkit.get_tools()

agent = initialize_agent(
    tools,
    ChatOpenAI(model="gpt-4o"),
    agent=AgentType.OPENAI_FUNCTIONS,
    verbose=True,
)
agent.run("Check my casino balance, scan trading markets for opportunities, and list my open positions")

Quickstart — Individual Tools

from langchain_purpleflea import (
    CasinoPlay, CasinoGetBalance, CasinoListGames,
    TradingOpenPosition, TradingListMarkets, TradingClosePosition, TradingListPositions,
    WalletTool, SwapTool, BalanceTool,
    DomainSearchTool, DomainPurchaseTool,
)

API_KEY = "sk_live_..."

tools = [
    CasinoGetBalance(api_key=API_KEY),
    CasinoListGames(api_key=API_KEY),
    CasinoPlay(api_key=API_KEY),
    TradingListMarkets(api_key=API_KEY),
    TradingOpenPosition(api_key=API_KEY),
    TradingListPositions(api_key=API_KEY),
    TradingClosePosition(api_key=API_KEY),
    WalletTool(api_key=API_KEY),
    SwapTool(api_key=API_KEY),
    BalanceTool(api_key=API_KEY),
    DomainSearchTool(api_key=API_KEY),
    DomainPurchaseTool(api_key=API_KEY),
]

Tool Reference

Casino Tools

Trading Tools

Wallet Tools

Domain Tools

Referral Program

Every Purple Flea product has a referral program. Agents earn:

• Casino: 10% of referred agents' net losses
• Trading: 20% of referred agents' trading fees — forever
• Wallet: 10% of referred agents' swap fees

Pass referral_code to PurpleFleatoolkit or embed it in WalletTool/DomainPurchaseTool calls to activate.

CrewAI Example

from crewai import Agent, Task, Crew
from langchain_purpleflea import PurpleFleatoolkit

tools = PurpleFleatoolkit(api_key="sk_live_...").get_tools()

trader = Agent(
    role="Autonomous Trader",
    goal="Monitor 275 markets and execute profitable perpetual futures trades",
    backstory="You are a quantitative trader with access to all Hyperliquid markets via Purple Flea.",
    tools=tools,
)

task = Task(
    description="Identify the top trending market and open a $100 long position with 5x leverage.",
    expected_output="Position ID, entry price, and liquidation price.",
    agent=trader,
)

Crew(agents=[trader], tasks=[task]).kickoff()

Links

• Purple Flea
• API Docs
• GitHub
• PyPI

License

MIT