Skip to content
Developers

Use Wayfinder outside the app

Your agent needs a model, market data, and a way to trade. One Wayfinder API key covers all three, in the tools you already use.

One key

One key, four things

Put the key in as a model provider and your agent gets a model. Add the SDK's MCP server and it gets the tools too.

ModelsAn OpenAI-compatible endpoint at https://llm.wayfinder.ai/v1, billed to your Wayfinder AI credits.
Crypto dataToken data, prices, ABIs, wallets, and quotes from the Wayfinder API.
RPCJSON-RPC for Base, Ethereum, Arbitrum, and more, on the same key.
WalletsFind your Wayfinder wallets, read balances, swap, and send, with gas sponsored on the main EVM chains.
Inference

Use your AI credits anywhere

Point any OpenAI-compatible tool at Wayfinder and it runs on your AI credits. Top up in $PROMPT and they cost less.

  • deepseek-v4-proDeepSeek V4 Pro
  • deepseek-v4-flashDeepSeek V4 Flash
  • glm-5.3GLM-5.3
  • glm-5.3-flashGLM-5.3 Flash
  • kimi-k3Kimi K3
  • gpt-5.6-solGPT-5.6 Sol
  • gpt-5.6-terraGPT-5.6 Terra
  • gpt-5.6-lunaGPT-5.6 Luna

These are the models Wayfinder agents run; /v1/models lists everything the endpoint serves. Tools must use chat completions, so set them up as a custom OpenAI-compatible provider.

curl https://llm.wayfinder.ai/v1/chat/completions \
  -H "Authorization: Bearer $WAYFINDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-v4-flash", "messages": [{"role": "user", "content": "What moved in perps today?"}]}'
from openai import OpenAI

client = OpenAI(base_url="https://llm.wayfinder.ai/v1", api_key=WAYFINDER_API_KEY)
reply = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[{"role": "user", "content": "Summarize funding on HYPE"}],
)
Build

Give your agent the tools

Install the SDK, add your key, and your agent can find your Wayfinder wallets, read balances, swap, and send.

uv tool install wayfinder-paths
About 70 MCP toolsThe SDK runs a local MCP server over stdio, so any MCP-capable agent gets Wayfinder's data, RPC, and wallet tools.
The same data the app usesToken search, prices, onchain quotes, and contract ABIs, without signing up for ten separate APIs.
Harnesses

Works with the agents you already use

Each of these was tested end to end on Wayfinder: tools called, a swap and a send confirmed onchain.

OpenCodeSet the provider in opencode.json and gate fund-moving tools with permission: ask.
HermesRuns in Docker. Hermes never asks before a tool call, so exclude the fund-moving tools you don't want it to use.
CodeWhaleUse Ask mode, or allow only the tools you want with --allowed-tools.
Claude Code and CodexInstall the SDK and point them at your key. Claude Code runs on your Wayfinder credits, powered by DeepSeek.
Claude Code on your Wayfinder credits, powered by DeepSeek
export ANTHROPIC_BASE_URL=https://llm.wayfinder.ai
export ANTHROPIC_AUTH_TOKEN=$WAYFINDER_API_KEY
claude

Developer questions

Do I need Pro to use the API key?

No. Any account with an API key and AI credits can call the endpoint. Free includes $1 of credits a month, which an agent uses up quickly, so most people top up.

How do I pay for credits?

Top up in the app under Settings, then Plan, then Pay with crypto, in USDC or $PROMPT on Base. $PROMPT is 10% off. Card works too.

Which API format does it speak?

OpenAI chat completions, for every model. The Responses API works for GPT models only, so configure your tool as a custom OpenAI-compatible provider rather than its built-in OpenAI option.

Does Claude Code give me Anthropic's Claude models?

No. Claude Code runs on your Wayfinder credits, powered by DeepSeek. It may still show a Claude model name in its interface.

Does Wayfinder hold my keys?

No. Wayfinder is non-custodial, and the agent never holds a private key: it asks Wayfinder to sign with your API key, within the wallet's limits.