Everyone built hands, eyes, and ears. We built the brain

What Ocean Agent is

An AI native trading layer for Pacifica. It comes in two parts: an MCP server your AI client calls on demand, and a 24/7 autonomous entity that trades on its own inside a policy you set.

The official Pacifica MCP passes the API through as is: your AI has to compute exact prices and sizes, and a wrong tick or lot gets rejected. Ocean Agent adds the layer above that: tick, lot, and min order correction, risk based sizing, a confirm gate, measured statistics, and self learning.

From zero to running

Live on PyPI. Nothing to preinstall, one command sets everything up. The autonomous bot is optional.

Start in dry mode until you understand exactly what it does.

Install

First install the Claude desktop app, then take either route below: paste the line into PowerShell yourself, or hand it to Claude in the Code tab and let it run. Both end the same way, with a form in your browser for your wallet address and API key; everything else, including Python and Claude's config, is set up for you.

irm https://oceanagent.fi/install.ps1 | iex

Install Ocean Agent: irm https://oceanagent.fi/install.ps1 | iex

sh -c "$(curl -LsSf https://oceanagent.fi/install.sh)"

uv run --with ocean-agent python -m ocean_agent.doctor

uv run --with ocean-agent python -m ocean_agent.autonomous --dry

ADDRESS=your_wallet_address
PACIFICA_API_KEY=your_agent_key
PACIFICA_BASE_URL=https://api.pacifica.fi

{ "mcpServers": { "ocean-agent": {
    "command": "uvx", "args": ["ocean-agent@0.4.76"],
    "env": { "PACIFICA_ENV_FILE": "/absolute/path/to/.env" } } } }

uv run --with ocean-agent python -m ocean_agent.doctor

Ocean Agent Approve

Mobile: your bot in Telegram

Everything Ocean Agent does can be driven from your phone through a Telegram bot that belongs to you alone. Your computer keeps running the engine; the bot is the private line between your phone and that machine. One bot serves one owner and we never see it, which is why you create your own in a minute instead of sharing anyone else's.

Do the Install step first, then these three.

/start

How Ocean Agent compares

Seven AI trading agents in one table. Every other one either lets a model guess or debate, or piles on rules. Here is what actually separates them, unpacked.

Measured edge, not opinion

A signal only trades if it beats the market's own drift, on that specific coin and timeframe, net of fees. Everything a decision touches is a measured number.

It studies its own results

The loop that makes it better over time. It learns only from its own signal trades, so nothing else pollutes the measured edge.

Runs while you sleep, never runs blind

A separate always on process governed by a policy file, a delegation contract it cannot act outside of.

Thirteen things the passthrough doesn't have

Each one answers a question a trader actually asks, with data instead of an opinion.

The plays it can run

Every strategy is measured and gated. If it can't beat the existing logic, it doesn't ship.

One policy file governs everything

The autonomous entity acts only inside these bounds. Widen them carefully.

Built so mistakes are structurally hard

The safety layer sits under every money moving action.

Risk. This is trading software. Leveraged perpetuals can lose more than the margin you post. Measured win rates come from historical data and are regime dependent. Nothing here is financial advice. Only risk what you can afford to lose.

Capability grows only as live evidence earns it

Correctness and risk first. Each phase unlocks only when a live data gate is met.

Where we win, and where we honestly don't

Common questions

What changed, and what we measured

Every entry states the change and the measurement behind it. When a measurement said the current setting was already better, we kept it and wrote that down too. Backtest figures assume perfect fills and exclude funding. They describe past regimes, not forecasts.

Open beta begins

0.4.76: One less step when you install

0.4.75: The next trade could go in at an old price

0.4.74: A rules file can let a held seat go

0.4.73: The board is ranked on the book the order goes to

0.4.72: Repeat alerts fold into one

0.4.71: A close that fails puts the stop back

0.4.70: The board builds without stopping the loop

0.4.69: The setup check is in English

0.4.68: An empty board is an answer

0.4.67: The stop rests at the exchange

0.4.66: A rules file of your own, if you want one

0.4.62: A release check that cannot read the wrong file

0.4.61: Ninety days of history decide the order

0.4.60: The stop sells at its own price too

0.4.58: A shorter horizon for direction, and a wider bracket

0.4.38: The first ask now answers

0.4.37: Wording, docs, and packaging

Testers go live on real orders

0.4.2: Crash recovery that checks its facts, and a Telegram bot in 11 languages

0.4.0: A measured trading engine

0.4.1: Twenty eight review findings, fixed and verified

Routine security review

Wider stops, measured; and a consent based developer fee

Ocean Agent is live on PyPI

Full backtest harness, and seven bugs it found

MCP server audit, and Print closed out

Separating what it knows from what it hopes

Terms of use

Last updated: August 7, 2026 · Effective immediately for all users. Please read these terms carefully before downloading, installing, or using the Ocean Agent software or this site. By doing any of those things you agree to be bound by these terms. If you do not agree, do not use the software.

1 · Introduction and definitions

These Terms of Use ("Terms") govern your use of the Ocean Agent software and of this website. In these Terms:

• "Software" means the ocean-agent package published on PyPI, including its MCP server, its autonomous trading process, its command line utilities, its bundled measurement data, and this website's install scripts;
• "Authors" means the developers and contributors of the Software;
• "Exchange" means Pacifica, the third party trading venue the Software connects to;
• "Agent Key" means the API key you create at the Exchange and supply to the Software;
• "AI Client" means any MCP compatible application (such as Claude) that you connect to the Software;
• "Autonomous Mode" means the optional always on process that scans markets and places orders without per order confirmation;
• "You" means the person installing or using the Software.

The Software is source available software released under the Business Source License 1.1, converting to the MIT License on 2030-08-25. It is a tool that runs entirely on your own computer. The Authors do not operate a service, do not run servers that touch your funds or orders, and have no ongoing relationship with you beyond publishing the code. The Software is not affiliated with, endorsed by, or operated by the Exchange.

2 · Unregulated software: no protections

No financial regulator in any jurisdiction has licensed, reviewed, or approved the Software or the Authors. The Authors are not a bank, exchange, broker dealer, investment adviser, fund manager, money transmitter, or wallet provider. Using the Software gives you none of the protections that apply to regulated financial services: no deposit insurance, no investor compensation scheme, no segregation of client assets, and no financial ombudsman or complaints tribunal you can escalate to. If something goes wrong, the realistic remedies are limited to those in Section 15.

3 · Eligibility

You may use the Software only if all of the following are true:

• you are at least 18 years old and legally able to enter into binding contracts;
• you are not located in, and do not access the Exchange from, a jurisdiction where trading leveraged cryptocurrency derivatives is restricted or prohibited, including any jurisdiction the Exchange itself blocks or restricts (the Exchange's own list, which may change at any time, controls);
• you are not a resident or citizen of, and are not accessing from, any country subject to comprehensive sanctions, and you are not on any sanctions or restricted party list (including OFAC, UN, and EU lists);
• you will not use VPNs or other means to disguise your location in order to access the Exchange from a restricted jurisdiction;
• your use of the Software and of the Exchange is lawful where you live.

Determining all of the above is solely your responsibility. The Software performs no identity verification and cannot check any of it for you.

4 · No accounts, no registration, no data collection

The Software has no sign up, no login, and no user database. The Authors do not collect, store, or transmit your personal data, your keys, your balances, or your trading history, everything the Software records lives in files on your own computer. This site is a static page and sets no tracking of its own. The only parties that see your activity are the Exchange (which you have a direct relationship with under its own terms) and, if you use an AI Client, that client's provider.

5 · Non custodial design: wallets and keys

The Software never holds your funds and never sees your wallet's seed phrase. It signs requests locally with the Agent Key you supply and sends them straight to the Exchange. The Software never moves your funds off the Exchange or to any address other than your own; its one withdrawal call returns a finished Print deposit to your own account. The permissions the Agent Key itself carries are set by the Exchange, and you can revoke it there at any time. Signed requests go directly from your computer to the Exchange, there is no intermediate server.

Because of this design, the Authors cannot: access your account, freeze or unfreeze anything, recover keys you lose, cancel or reverse orders, or return funds. There is no support desk that can undo a trade. Anyone who obtains your Agent Key can trade your account until you revoke it; keeping it secret, and keeping the computer it lives on secure, is entirely your responsibility.

6 · The MCP server and AI clients

The Software's MCP server exposes trading and analysis tools to the AI Client you connect. You acknowledge that:

• AI language models can misunderstand instructions, make mistakes, and state wrong things confidently. Review what your AI Client is about to do before confirming orders;
• tools that move money require an explicit confirmation parameter, but your AI Client controls how that confirmation is presented to you;
• the quality of decisions made through an AI Client depends on that client and its model, neither is under the Authors' control;
• analysis tools output measurements of past data. They are not predictions and not advice (Section 14).

7 · Autonomous Mode

If you start Autonomous Mode with a trading key, the Software will place real, leveraged orders by itself, around the clock, without asking you first, that is its purpose. It operates inside a policy file you control (capital, risk per trade, leverage cap, stop rules), but within those bounds its decisions are its own. You are responsible for every order placed under your key, including orders you never personally reviewed. Run it in dry mode (decisions logged, no orders) until you understand exactly what it does, keep the policy file conservative, and check on it regularly. The Software adapts parameters within policy bounds; it never rewrites its own code.

8 · Experimental features and undocumented endpoints

Some features, notably Print, rely on Exchange endpoints that are not officially documented. They may change or stop working at any time without notice, and their behavior in edge cases is not guaranteed by anyone. Features marked experimental are provided for evaluation only; using them with real funds is at your own heightened risk.

9 · Orders are irreversible: no refunds

Orders executed on the Exchange are final. Cryptocurrency transactions cannot be recalled, and leveraged positions can be liquidated before you have a chance to react. Because the Software never holds funds, the Authors have nothing to refund from and cannot issue refunds, reimbursements, or compensation under any circumstances, including losses caused by bugs, misconfiguration, compromised keys, or fraud by third parties.

10 · Access is controlled by the Exchange, not the Authors

The Authors have no power to suspend or terminate your trading, and equally no power to restore it. The Exchange may restrict, suspend, or close your account under its own terms at any time, may delist markets, change fees, or halt trading. None of that is within the Authors' control, and the Software may stop working, in whole or in part, whenever the Exchange changes its API.

11 · Fees

The Software itself is free to install and use. All trading fees, funding payments, and spreads are set and collected by the Exchange under its own schedule, which can change. The Software's expected value calculations account for fees as measured at the time; actual fees may differ.

Developer fee (builder code). During installation you are asked whether to approve a builder fee of 0.01% (1 bps) of each filled order's notional value, paid to the Authors through the Exchange's builder code program. Approval is optional and takes effect only with your own cryptographic signature; the Software never approves it silently. Declining does not change any functionality. You can revoke an approval at any time in your Exchange account settings, and the Exchange rejects any order whose builder fee would exceed the cap you signed.

12 · Taxes

Trading profits and losses may create tax obligations where you live. Determining, reporting, and paying any such taxes is solely your responsibility. The Software's records are kept for its own learning loop and are not tax documents; do not rely on them as complete or authoritative for tax purposes.

13 · Privacy

Everything the Software learns (trade history, win rate databases, measurement matrices, logs) is stored locally on your machine and never transmitted to the Authors. There is no telemetry, no analytics, and no phone home. Your network traffic goes to the Exchange (to trade) and to public package registries (to install). If you optionally configure notifications, those go to the provider you configure.

14 · Disclaimers and risk statement

No advice

Nothing the Software or this site outputs is investment advice, a recommendation, an offer, or a solicitation to trade. Win rates, expected values, backtests, forecasts, and "recommended settings" are measurements of past price data produced by code, not predictions, and not tailored to you. The Authors are not licensed financial advisors and know nothing about your circumstances. If you need advice, consult a licensed professional.

Market risk

Cryptocurrency prices are extremely volatile and trade around the clock. Leveraged perpetual futures amplify both gains and losses: positions can lose more than the margin posted and can be liquidated entirely. Stop loss orders are not guarantees, in a fast market or a price gap the fill can be far worse than the stop price, or the stop may not fill at all. Thin order books add slippage that can exceed the edge being traded.

Strategy risk

The Software's measured edges are small, measurement puts the realistic directional ceiling in this market only slightly above a coin flip, and backtested figures above that did not survive out of sample testing. Edges that small are fragile: they can vanish when the market regime changes and are easily erased by fees and slippage. Past measurement does not guarantee future results. A period of profits is not proof the system works; a period of losses is possible at any time.

Technical risk

Software has bugs. The Software may miscalculate, crash, lose connectivity, or behave unexpectedly after an Exchange API change. Your own machine may fail, sleep, lose power, or be compromised. The Exchange may go down while you hold positions. Exchange native stops remain on the Exchange's servers if your machine goes offline, but everything else the Software manages stops with it.

As is

The Software and this site are provided "as is" and "as available", without warranty of any kind, express or implied, including merchantability, fitness for a particular purpose, accuracy, non infringement, or uninterrupted operation.

15 · Limitation of liability

To the maximum extent permitted by applicable law, the Authors and contributors shall not be liable for any loss or damage of any kind arising out of or in connection with the Software or this site, including, without limitation, trading losses, lost profits, liquidations, losses caused by software defects, incorrect calculations, stale data, Exchange outages or API changes, network failures, misconfiguration, compromised credentials, actions taken by an AI Client, or security incidents on your machine, whether in contract, tort, or otherwise, even if advised of the possibility of such damage. Where liability cannot be excluded by law, it is limited to the amount you paid for the Software, which is zero. Nothing in these Terms excludes liability that cannot lawfully be excluded, such as liability for fraud.

16 · Your representations and warranties

By using the Software you represent and warrant that:

• you meet the eligibility conditions in Section 3;
• the funds you trade were acquired lawfully;
• you have the technical ability to install, configure, and supervise the Software, or accept the consequences of not supervising it;
• you understand leveraged derivatives and the risks in Section 14;
• you are acting for yourself, not on behalf of another person or entity;
• you will not use the Software for market manipulation, money laundering, sanctions evasion, or any unlawful purpose.

17 · Term and stopping use

These Terms apply from your first use of the Software until you stop using it. You can stop at any time: close positions, revoke your Agent Key at the Exchange, and uninstall. Revoking the key immediately removes the Software's ability to trade your account. Sections that by their nature should survive (disclaimers, limitation of liability, and governing terms) survive termination.

18 · Security obligations

You are responsible for: keeping your Agent Key and .env file secret and out of version control and chat messages; securing the computer the Software runs on; reviewing the policy file before running Autonomous Mode with real funds; revoking keys promptly if you suspect compromise; and monitoring positions the Software opens. If your key leaks, revoke it at the Exchange immediately, that invalidates it at once.

19 · Force majeure

The Authors are not responsible for any failure or delay caused by events beyond reasonable control, including natural disasters, war, civil unrest, labor disputes, power or internet outages, actions of governments or regulators, Exchange failures, blockchain congestion or forks, or failures of third party infrastructure.

20 · Changes to these Terms and to the Software

These Terms may be updated as the Software evolves, to reflect new features, removed features, legal requirements, or clarity improvements. The current version always lives on this page with the date above; material changes will be reflected in the project changelog. Continuing to use the Software after a change means you accept the updated Terms. The Software itself may change at any time: features can be added, altered, or removed, and published measurement data can be revised as new measurements replace old ones.

21 · Open source license and intellectual property

The Software's source code is licensed under the Business Source License 1.1, which governs your rights to use, copy, modify, and redistribute the code, and which converts to the MIT License on 2030-08-25. Under BUSL you may read, modify and run the code for your own trading, research and other non-production use; offering it as a competing commercial trading service is not permitted before the change date. These Terms do not restrict rights that license grants you; they govern your use of the Software against a live exchange account and your use of this site. Trademarks, names, and logos of the Exchange and of AI Client providers belong to their respective owners. You are encouraged to read the source before connecting real funds, it is public precisely so you can verify what it does.

22 · General

Entire agreement. These Terms and the Business Source License 1.1 are the entire agreement between you and the Authors concerning the Software, replacing any prior statements. Severability. If any part of these Terms is found unenforceable, the rest remains in effect. No waiver. Not enforcing a provision is not a waiver of it. Assignment. You may not assign these Terms; the license travels with the code. No relationship. Nothing here creates a partnership, agency, fiduciary, or advisory relationship between you and the Authors. Disputes. Before pursuing any formal claim, contact the project through its public repository or package page and allow 30 days for an informal resolution. Any dispute shall be resolved on an individual basis; to the extent permitted by law, you waive participation in class or representative actions against the Authors. Language. These Terms are written in English; translations are provided for convenience and the English text prevails.

One sentence version: this is free, unregulated, open source software that trades real money with real leverage under your own key. If you are not prepared to lose the funds in the connected account, do not connect it.