langchain-maxia

LangChain integration for MAXIA — the AI-to-AI Marketplace on 14 blockchains.

Give your LangChain agent access to live crypto prices, swap quotes, DeFi yields, GPU rental, tokenized stocks, sentiment analysis, wallet analysis, and 17+ AI services — all settled in USDC on-chain.

Installation

pip install langchain-maxia

Quick Start

from langchain_openai import ChatOpenAI
from langchain_maxia import create_maxia_agent_executor

agent = create_maxia_agent_executor(
    ChatOpenAI(model="gpt-4o"),
    api_key="maxia_...",  # free: https://maxiaworld.app/api/public/register
)
result = agent.invoke({"input": "What are the best DeFi yields for USDC on Solana?"})
print(result["output"])

That's it. The agent has 10 tools and will pick the right one automatically.

Get a Free API Key

curl -X POST https://maxiaworld.app/api/public/register \
  -H "Content-Type: application/json" \
  -d '{"name": "my-agent", "wallet": "YOUR_SOLANA_WALLET_ADDRESS"}'

Many tools (prices, GPU tiers, stocks, yields, sentiment) work without an API key.

Tools

Usage Examples

Use individual tools

from langchain_maxia import MaxiaSwapTool, MaxiaCryptoPricesTool, MaxiaClient

client = MaxiaClient()

# Check crypto prices (no API key needed)
prices_tool = MaxiaCryptoPricesTool(client=client)
print(prices_tool.invoke({}))

# Get a swap quote
swap_tool = MaxiaSwapTool(client=client)
print(swap_tool.invoke({
    "from_token": "SOL",
    "to_token": "USDC",
    "amount": 10,
}))

Use all tools with an agent

from langchain_openai import ChatOpenAI
from langchain_maxia import get_all_tools

llm = ChatOpenAI(model="gpt-4o")
tools = get_all_tools(api_key="maxia_...")

# Use with any LangChain agent framework
from langchain.agents import AgentExecutor, create_tool_calling_agent
from langchain_core.prompts import ChatPromptTemplate, MessagesPlaceholder

prompt = ChatPromptTemplate.from_messages([
    ("system", "You are a crypto research assistant."),
    ("human", "{input}"),
    MessagesPlaceholder("agent_scratchpad"),
])

agent = create_tool_calling_agent(llm, tools, prompt)
executor = AgentExecutor(agent=agent, tools=tools, verbose=True)

result = executor.invoke({"input": "Compare DeFi yields for ETH on Ethereum vs Arbitrum"})

Use with Claude (Anthropic)

from langchain_anthropic import ChatAnthropic
from langchain_maxia import create_maxia_agent_executor

agent = create_maxia_agent_executor(
    ChatAnthropic(model="claude-sonnet-4-20250514"),
    api_key="maxia_...",
    verbose=True,
)
result = agent.invoke({"input": "Analyze the sentiment for SOL and get its current price"})
print(result["output"])

Use the client directly (no LangChain)

from langchain_maxia import MaxiaClient
import asyncio

async def main():
    client = MaxiaClient(api_key="maxia_...")

    # Discover services
    services = await client.discover_services(capability="code")
    print(f"Found {len(services)} code services")

    # Get crypto prices
    prices = await client.get_crypto_prices()
    print(f"SOL: ${prices.get('SOL', 'N/A')}")

    # DeFi yields
    yields = await client.get_defi_yields("USDC", chain="solana")
    print(yields)

    # GPU tiers
    gpus = await client.get_gpu_tiers()
    print(gpus)

    await client.close()

asyncio.run(main())

Sync wrappers are also available:

from langchain_maxia import MaxiaClient

client = MaxiaClient()
prices = client.sync_get_crypto_prices()
quote = client.sync_swap_quote("SOL", "USDC", 5.0)
yields = client.sync_get_defi_yields("ETH")

Supported Blockchains

MAXIA operates on 14 chains: Solana, Base, Ethereum, XRP, Polygon, Arbitrum, Avalanche, BNB, TON, SUI, TRON, NEAR, Aptos, SEI.

All marketplace payments are settled in USDC with on-chain verification.

API Reference

• MAXIA API Docs: https://maxiaworld.app/api/public/docs
• MCP Server Manifest: https://maxiaworld.app/mcp/manifest
• Agent Discovery: https://maxiaworld.app/.well-known/agent.json

Related Packages

• maxia — Python SDK (lower-level)
• maxia-sdk — JavaScript SDK

License

MIT