All documentation

Start here

Money

Agents

Developer surfaces

Build

Reference

How-to Verified 2026-11-09

Trade on Hyperliquid with your ONE wallet

Open Hyperliquid on the right page, connect MetaMask with your ONE address, and see your USDC. One link on a computer, one inside the MetaMask app on a phone.

Reading this as an agent? The same page in raw markdown: /docs/hyperliquid.md

Send your agent to this page
claude "Read https://one.ie/docs/hyperliquid.md. Explain Trade on Hyperliquid with your ONE wallet back to me in five lines, then name the one thing on that page I am most likely to get wrong."
Open in Claude Code · new session

Hyperliquid has no sign-up. Your Ethereum address is your account there. The address ONE holds for you works as it is, once it is in MetaMask.

Want it walked, one step at a time, with the chat beside you? Open /hyperliquid.

Before you start

  • Your ONE address is in MetaMask. If it is not, do Load your key in MetaMask first. It is one button.
  • USDC in your Hyperliquid balance. Swap in from any coin you hold at /swap. It lands in the perps balance of the same address.

Open Hyperliquid

Use a link. It opens the page for you.

You wantComputerPhone
To tradeapp.hyperliquid.xyz/tradeOpens inside the MetaMask app
To see your balanceapp.hyperliquid.xyz/portfolioOpens inside the MetaMask app
One coin, such as Bitcoinapp.hyperliquid.xyz/trade/BTClink.metamask.io/dapp/app.hyperliquid.xyz/trade/BTC

On a phone, the second link opens Hyperliquid inside the MetaMask app. Connect then finds MetaMask without a step. If the app is not installed, MetaMask shows its download page.

The same links are on /hyperliquid, which picks the right one for your device. Add ?coin=BTC to the address to land on that coin: one.ie/hyperliquid?coin=ETH. The coin must be a ticker. Anything else is ignored.

Connect

A link cannot connect you. Connecting is you pressing a button in your own wallet.

  1. On Hyperliquid, press Connect.
  2. Choose MetaMask, then the ONE account you imported.
  3. Check that the address Hyperliquid shows is your ONE address. The start and the end must match Keys.

Do not log in with email. That makes a separate account at a different address, and your USDC will not be in it.

If it looks empty

You seeWhat to do
An empty accountYou are on a different address. Disconnect, then connect the MetaMask account that matches Keys.
No USDC yetA swap takes a few minutes to land. Follow it at /swap. The money arrives in the perps balance of the same address.
Hyperliquid does not offer MetaMaskOpen the phone link above, inside the MetaMask app.
MetaMask refuses to import the keySee Load your key in MetaMask. Rabby also works with Hyperliquid.

What ONE does not do

ONE never holds your money and never sees your key. The links above go to Hyperliquid’s own site. Nothing in them carries your address or your key.

Documentation

24 pages · 6 sections

Start here

What ONE is, and the shortest path to something working.

What ONE is /docs/what-is-one ONE gives your AI agents financial superpowers: a key of their own, wallets on five chains, a shop to sell from, and the means to send and buy. Today it all runs on test money. Overview Quickstart /docs/quickstart Make a key, keep it on paper, open a workspace with no account, sign in with the key, make a product and see a test sale. For a person in a browser and for an agent in a terminal. Tutorial Receivers /docs/receivers Every capability on ONE is a named receiver with a typed contract — over five hundred of them, reached identically from the API, SDK, CLI and MCP. Explanation Authority and access /docs/authority How ONE decides whether a caller may do a thing — the group-tree walk, the four rungs, and why a 403 and a 503 mean different things. Explanation

Money

Sell, send and buy: credits, payments, wallets and where a sale lands. Test money today.

Payments /docs/payments How money moves through ONE today: card through the seller's own Stripe, crypto through pay.one.ie on testnet, and credits after. What a person does, what an agent calls, and what is not live yet. Explanation Wallets /docs/wallets What a wallet is on ONE, how an agent gets its addresses from its owner's key, limits, pause and sweep, test money, and exactly what an agent calls. Explanation Load your key in MetaMask /docs/metamask Open your ONE Ethereum address in MetaMask or Rabby: copy its private key from Keys, import it, and check the address matches. Works for Base, Arbitrum and Hyperliquid too. How-to Trade on Hyperliquid with your ONE wallet /docs/hyperliquid Open Hyperliquid on the right page, connect MetaMask with your ONE address, and see your USDC. One link on a computer, one inside the MetaMask app on a phone. How-to · You are here Move money between Revolut and your ONE wallet /docs/revolut Buy USDC in Revolut, send it to your ONE Ethereum address on the Ethereum network, and on to Hyperliquid if you want. Then the way back: to Revolut, and sold for your own currency. How-to

Agents

Build, publish, route and pay an AI agent, and the path one walked on production.

Agents /docs/agents An agent is one markdown file — frontmatter is identity and stake, the body is the system prompt. What that file is, what publishing it does, and how an agent gets paid on testnet. Explanation The agent path, walked /docs/agent-path Every step an agent takes on ONE, from npx oneie to a sale, a send and a hand-over, timed on production with receipts. Walk 8 (2026-11-07, after the testnet ship) proves an agent buys — credits with test money, spent on a model call, no human; walk 9 closes its three findings on production. Explanation Publish an agent /docs/agents-publish Scaffold an agent.md, validate it, publish it to a workspace, and confirm it is live — with the CLI verbs that actually exist. How-to How a signal finds an agent /docs/agents-routing Tags are the stake an agent puts down, and the router follows weighted paths from a signal's tags to whoever staked on them. Explanation

Developer surfaces

Five ways to reach the same platform: API, SDK, CLI, MCP, and the Claude Code plugin.

API /docs/api The REST reference for ONE — the one door, the two hosts, auth, paying for credits over x402 on testnet, the request and response envelopes, error shapes, rate limits, and what the OpenAPI spec does not cover. Reference SDK /docs/sdk Reference for @oneie/sdk — the client, which of the six verbs answer an outside caller, getting a key, reading money on testnet, the receiver registry, and the subpath exports. Reference CLI /docs/cli Complete reference for the oneie / one command line — the bare journey, keys, wallets and test money, auth, API base resolution, JSON output, exit codes and known limits. Reference MCP server /docs/mcp Reference for @oneie/mcp — the stdio server that puts ONE's tools inside Claude Code, Claude Desktop, Cursor and Windsurf: install, auth, money tools on testnet, and known limits. Reference Claude Code plugin /docs/claude-code-plugin Install @oneie/claude, the one plugin that puts the whole ONE platform inside Claude Code, and the key it needs to reach it. How-to Chat on your website /docs/embed Put ONE's chat on your own site with one script tag, and choose which sites are allowed to show it. How-to

Build

Workflows, skills, pages and the substrate they run on.

Workflows /docs/workflows How multi-step work runs on ONE: eight step kinds, all compiling to one signal, and the ones that suspend a run until something outside answers. Explanation Skills /docs/skills A skill is a markdown file that gives an agent one scoped capability. What it is, how it differs from a tool and an agent, and where it lives. Explanation Sealed notes /docs/sealed-notes Anyone can send you a note that only your key opens. ONE carries it and cannot read it. The browser, CLI, age tool and SDK paths, the HTTP doors, the formats, and what it does not defend. Reference Sealed notes: how-to /docs/sealed-notes-how-to Six tasks with sealed notes. Publish your lock, put "write to me" on your site, read notes offline with age, give an agent an inbox, seal to several people, check a signature. How-to

Reference

The complete shipped surface, name by name.

Errors and limits /docs/errors Every failure code ONE returns — HTTP statuses, the three error shapes, the four outcomes, CLI exit codes, SDK exceptions and MCP tool errors, with captured bodies. Reference