Bitpont MCP
Local MCP adapter for DeFi market discovery, portfolio reads and unsigned transaction preparation. Wallet owners review and sign supported actions.
Documentation
AI agent guides by task
Trading and Earn
- Quote token swaps and manage limit orders with an AI agent
- Bridge tokens and verify destination delivery
- Find lending markets, vaults and staking actions for an agent
- Find a liquidity pool and manage its position
- Trade perpetuals and inspect funding-rate markets
- Read the options chain and place Derive limit orders
- Build Hyperliquid spot and perpetual orders for the right market
- Initialize a Solana perps account and recover an order
- Borrow against collateral and repay a DeFi loan
- Open and unwind a Solana Multiply position
- Compare DeFi liquidity protocols and plan a position exit
Operations and recovery
- Plan Treasury payments and multi-step Operations
- Build an agent portfolio view across wallets and positions
- Verify trading fees and manage an agent’s API limits
- Track referral earnings and request payouts through the API
Try a request
Run a public example and inspect the actual API response.
{
"product": "hyperliquid"
}
Tool explorer
Find the REST path, MCP name and required inputs for a task.
270 tools. Open the directory for the full list.
API walkthroughs and signing reference
Make your first request
curl -sS https://www.bitpont.com/api/v1/agent
Read data.actions. Each entry gives the HTTP method, path and purpose. POST actions accept JSON. Successful results are in data. Save the response request ID when reporting an error.
curl -sS https://www.bitpont.com/api/v1/agent/tokens \
-H 'Content-Type: application/json' \
-d '{"chainId":"evm:1","q":"USDC","page":1,"limit":10}'
Use the returned chain ID, exact token address and decimals. Tokens with the same symbol can be different assets. Follow data.nextPage until it is null.
Connect an MCP client
Download the Bitpont MCP adapter and save it locally. In a client that supports stdio, choose node as the command and the absolute path to the downloaded file as its argument. Use Node.js 20 or newer. The adapter lists the agent actions, typed resource reads, portfolio planning, Treasury proposals and workflow tools. Each tool declares its inputs and access requirements. Keyless access is the default. For partner access set BITPONT_API_KEY in the local process environment.
{
"mcpServers": {
"bitpont": {
"command": "node",
"args": [
"/absolute/path/to/bitpont-agent-mcp.mjs"
]
}
}
}
Find the right API tool
Read the product directory or search by task and product. Results give the REST path, MCP name and access scope. Follow nextPage to see every match.
curl -sS https://www.bitpont.com/api/v1/agent/tools \
-H 'Content-Type: application/json' \
-d '{"product":"treasury","q":"payment","limit":20}'
- Swap and limit orders — CoW order and cancellation signatures are submitted to their native endpoint. Market swaps return wallet transactions.
- Bridge — The source transaction and destination delivery have separate confirmations.
- Earn and borrowing — Review token permissions, then request a fresh preparation for the economic action.
- Perpetuals and rates — Solana uses a wallet-signed native request. Hyperliquid orders use venue signing. GMX and Ostium prepare unsigned wallet transactions.
- Liquidity pools and positions — Use the exact pool identity, fee tier and token order. Solana pool transactions use the native liquidity API.
- Portfolio — Plan reads for selected wallets. Follow cursors and retain partially available positions.
- Treasury — Safe owners collect approvals for one exact hash before execution. Solana payment batches require a separate wallet signature.
- Operations — Choose a supported route or compose up to twelve steps. Wallet approvals and settlement are tracked per step.
- Options — Read live contracts for a listed underlying. Use the local Options MCP from the agent kit for authenticated account reads, limit orders and cancellation with your own wallet. The web workspace also supports venue login and signing.
- Hyperliquid spot and perpetuals — Inspect the exact protocol market, review live depth, then open the unsigned draft in the trading terminal.
- Business integrations — Choose a partner integration, estimate peak request units and send the workload brief to [email protected].
- Search, markets and help — Use exact asset addresses and paginate results.
- Referral programme — Sign the exact referral intent with your Solana wallet to use invitations, receipts and payout requests.
Manage a Safe proposal
Use the Treasury directory for the network and action. A free workspace can prepare a proposal. Keep its proposalToken and hash. Request the authorize stage for each owner who needs to approve. After the on-chain approvals meet the threshold, prepare and simulate the execute stage. Each transaction needs its own wallet signature. Reconcile the finalized receipt against the proposal hash. Token payments also require delivery checks.
Plan SOL or SPL payments
Supply distinct recipients, atomic amounts and a run ID. Prepare one returned batch at a time. Check the exact transaction signature before continuing or retrying.
Move funds between products
curl -sS https://www.bitpont.com/api/v1/agent/operations/workflow \
-H 'Content-Type: application/json' \
-d '{"network":"base","source":"aave","destination":"morpho","amount":"1.25"}'
Open the returned review URL. For a custom sequence, use /api/v1/compositions/prepare. Check each step before funding the next one. GET /api/v1/agent/operations lists supported networks and operator-enabled execution services.
Choose a product
Swap
Resolve a same-chain pair. For EVM swaps, quote the exact amount and wallet. Choose a route with partnerPreparation, then send its id to the prepare endpoint. For Solana, pass the quoted minimum into instruction preparation.
Bridge
Choose two different chain IDs. Request an indicative quote, or include both the source wallet and recipient for an executable quote. Review fees, minimum output, expiry and any warning before requesting the unsigned plan. Across and Circle CCTP support native USDC on Ethereum, Base and Arbitrum. THORChain supports native ETH to a mainnet Bitcoin payment address. These native routes carry their own fee terms.
Earn
Find opportunities by network and protocol. Read the exact vault, asset and wallet position. The Earn prepare endpoints cover supported deposits, withdrawals, lending actions, staking, claims and Pendle PT, YT and liquidity operations.
Perpetuals
Read markets on Solana, Hyperliquid, GMX and Ostium. GMX and Ostium have unsigned order builders. Solana order preparation uses the native /api/tx/order endpoint with wallet authentication. Hyperliquid orders require the venue’s signed exchange flow.
Options
Find listed underlying assets through the Options API. Open the returned workspace to review current strikes, premiums and expiries and authorize a Derive order.
Other services
Use the service directory for liquidity, Treasury, portfolio, orders and operations. The resource catalogue and integration manifest describe scoped account reads, batch requests and workflow drafts.
Find a native endpoint
curl -sS https://www.bitpont.com/api/v1/agent/services \
-H 'Content-Type: application/json' \
-d '{"family":"perps","q":"order","limit":20}'
Native endpoints keep their own wallet, session, rate and venue requirements. The action catalogue identifies the normalized API operations. A workspace link opens the product at its review screen.
Browse Earn and perpetual markets
curl -sS https://www.bitpont.com/api/v1/agent/earn/markets \
-H 'Content-Type: application/json' \
-d '{"network":"ethereum","limit":5}'
curl -sS https://www.bitpont.com/api/v1/agent/perps/markets \
-H 'Content-Type: application/json' \
-d '{"venue":"ostium","cursor":"0"}'
Prepare a native Solana perpetual order
Read the Solana markets and use the returned market index. To prepare an order, POST its JSON body to /api/tx/order. The owner authorizes this individual API request by signing its exact path, timestamp and JSON body hash. Send the wallet public key in x-wallet, the Unix millisecond timestamp in x-ts and the base58 detached signature in x-sig.
velocity.api.v1|/api/tx/order|<timestamp-ms>|<lowercase SHA-256 hex of JSON.stringify(body)>
Sign the UTF-8 bytes of that message. Use a fresh signature for each request. If the response requests account initialization, review that step first. Inspect and simulate the returned unsigned transaction before asking for transaction authorization. Open the Solana Perps workspace.
Resolve a USDC bridge from Ethereum to Base
curl -sS https://www.bitpont.com/api/v1/agent/route \
-H 'Content-Type: application/json' \
-d '{"sourceChain":"evm:1","from":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","destinationChain":"evm:8453","to":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"}'
Open data.reviewUrl for the Bitpont ticket, or POST the same asset fields to /api/v1/agent/bridge/quote with an amount and slippageBps. For USDC with six decimals, "1000000" is one USDC. A slippage limit of 50 is 0.5%.
For a wallet-bound quote, also include sourceWallet and recipient. When executable is true, send the returned quoteId and the same addresses to /agent/bridge/prepare under the same API client. After the wallet submits, use the returned order identity and the source transaction hash with /agent/bridge/status.
All agent API endpoints
All paths below are relative to /api/v1. The OpenAPI document specifies required fields and units.
POST /agent/bridge/fees/follow
Follow one source order from its ID to collection evidence and the next required action.
POST /agent/bridge/fees/orders
Find source-unlocked deBridge orders by the configured beneficiary and referral. Provider results are discovery evidence.
POST /agent/bridge/fees/receipt
Verify source order creation and affiliate settlement on EVM. Native fees need matching transfer traces.
POST /agent/bridge/fees/balance
Read the finalized deferred EVM fee balance. Use the zero address for a native asset.
POST /agent/bridge/fees/withdraw
Prepare an exact EVM withdrawal of deferred fees to the fixed Bitpont recipient.
POST /agent/bridge/fees/withdrawal-receipt
Prove an aggregate EVM fee withdrawal separately from individual orders.
POST /agent/bridge/fees/solana/state
Inspect the finalized DLN state and escrow for one Solana source order.
POST /agent/bridge/fees/solana/withdraw
Build and simulate one manual DLN fee claim for the configured Solana beneficiary.
POST /agent/bridge/fees/solana/receipt
Verify a finalized DLN withdrawal and a matching credit to the beneficiary token account.
POST /agent/referrals/intent
Prepare an exact Solana wallet proof for referral earnings, receipt history, accepting an invitation or requesting payout.
POST /agent/referrals/apply
Use the wallet-signed referral intent. A payout request enters manual treasury review.
POST /agent/earn/paths
Find Earn, lending, borrowing, Multiply and pool workflows by protocol, network, or intent. Each result identifies its reads, wallet-signed preparation and exit.
POST /agent/earn/path-tools
Load one protocol and network workflow together with its actual tool schemas, market and wallet reads, entry, exit and ticket routing.
POST /agent/guides/search
Find a Bitpont AI agent guide by task, product or tool. Follow its canonical HTML, Markdown or MCP resource.
POST /agent/guides/read
Read the steps, real tool names, example and related guides for an exact guide slug.
POST /agent/workflow/check
Validate up to twelve proposed calls against the tool catalogue before using a provider or signing. No calls are executed.
POST /agent/workspace
Create a private workspace for keyless execution and receipt recovery. Keep the returned secret private and reuse it.
POST /agent/execution/fee-access
Verify a fee received on your own submitted ticket. Qualifying payments lift the standard quota for one hour. A quote or promised fee earns no access.
POST /agent/execution/plan
Check the inputs for up to twelve ordered actions against the same schemas used by executionPrepare. Returns field corrections without contacting a venue or creating tickets.
GET /agent/execution/routes
List supported signing and submission operations, permissions and settlement tracking.
POST /agent/execution/sessions/owner-revoke
Customer revocation. An owner signature stops pending session actions without the integration key.
POST /agent/execution/sessions/prepare
Show the customer the exact wallet, actions, integration and deadline for a single-use batch.
POST /agent/execution/sessions/activate
Owner integration only. Register the signed consent and externally signed exact actions.
POST /agent/execution/sessions/run
Execute one unused authorized action without another wallet prompt.
POST /agent/execution/sessions/status
Inspect the permission, actions and submission references.
POST /agent/execution/sessions/revoke
Stop unused actions in a customer session immediately.
POST /agent/execution/prepare
Build a wallet-bound signing request using the named product adapter. Supply a unique UUID for recovery.
POST /agent/execution/submit
Submit an already authorized signature or signed transaction for an exact execution ticket. A timeout may mean it was sent.
POST /agent/execution/receipts
List your saved execution receipts newest first without polling providers. Continue with nextCursor as before.
POST /agent/execution/lookup
Recover your exact saved receipt by the request ID originally used to prepare it.
POST /agent/execution/status
Recover a submission attempt by ticket and read its network or venue identifier.
POST /agent/execution/revoke
Disable an unused execution ticket before submission.
POST /agent/earn/solana/prepare
Build a simulated Solana Earn deposit or withdrawal against an exact product.
POST /agent/earn/marinade/prepare
Prepare staking, an unstake request or a claim for its ticket.
POST /agent/earn/solana/lending
Prepare lending collateral, withdrawal, borrowing or repayment for an exact Solana position.
POST /agent/earn/solana/multiply
Prepare a Solana Multiply position using the native validated strategy inputs.
POST /agent/perps/solana/build
Build a Solana perpetuals transaction using the original wallet-authenticated request and signature.
POST /agent/swap/solana/transaction
Compile and simulate a Jupiter transaction with the reviewed minimum output and fee account.
POST /agent/coverage
Inspect typed product tools, configured adapters, native workspace routes and external signing handoffs on this deployment.
POST /agent/hyperliquid/order/draft
Review a Hyperliquid limit, market, protective or TWAP order and open the exact market with its ticket filled in. A wallet must authorize an order.
POST /agent/liquidity/solana/prepare
Prepare and simulate the first Orca, Meteora or Raydium position transaction. Token amounts are base-unit strings.
POST /agent/liquidity/solana/step
Read a reviewed Solana liquidity step after prior confirmed delivery. Use the plan ID, wallet and zero-based step index.
POST /agent/swap/limit/prepare
Prepare an exact-maker Kyber limit order and validated typed data for owner review. Returns the declared application fee.
POST /agent/swap/limit/cancel
Prepare a validated unsigned cancellation for one Kyber order ID, hash, network and maker.
GET /agent/business
List integration paths for businesses, partners and AI platforms, including documentation and API limit contacts.
POST /agent/business/plan
Estimate request units for a partner workload and return the integration brief and support contact.
POST /agent/tools/describe
Look up one tool by ID, MCP name or REST path. Returns its input schema, access, sample requests and related recipes.
POST /agent/tools/check
Check a tool request locally against its published input schema. Receive field-by-field correction hints without calling its provider.
POST /agent/recipes
Find guided tasks across Bitpont products. Each recipe starts with a concrete discovery or draft request.
POST /agent/recipes/open
Read the first request, ordered follow-up tools, access requirements and owner review for one task.
POST /agent/assets/find
Search exact symbols, names or addresses across network catalogues. Identical symbols on different networks remain separate.
POST /agent/assets/convert
Convert display amounts and base-unit strings using the decimals of an exact network and asset address, with no floating-point rounding.
POST /agent/route/resolve-pair
Resolve a route by exact symbol or address on each specified network. Returns candidates for ambiguous symbols before choosing a route.
POST /agent/treasury/safe/propose
Prepare a bounded Safe proposal for streams, distributions, wrapping, lending or nonce cancellation. Amounts use human-readable units. Stream amounts are monthly equivalents.
POST /agent/treasury/safe/stage
Refresh one exact Safe proposal and prepare either an owner approval or a simulated threshold execution.
POST /agent/treasury/safe/receipt
Check finality and the exact Safe ExecutionSuccess or ExecutionFailure event. Custom token payments also require matching recipient transfers.
POST /agent/operations/asset/prepare
Prepare an exact wallet transfer, registered native wrap or unwrap, or a zero-allowance revocation on a supported EVM network.
POST /agent/operations/workflow
Draft a supported USDC operation between wallet, Earn and Perps accounts. Amounts are human-readable USDC.
GET /agent/products
Find a Bitpont product, its workflows, API operations, access requirements and wallet handoffs.
POST /agent/tools
Search Bitpont agent actions, resource reads and product workflows by product, task or tool name.
POST /agent/operations/outcomes
Find supported financial outcomes and open the Operations builder on an exact network.
POST /agent/treasury/tools
Find Treasury tools by network, task and custody type, with a canonical workspace and next API action.
GET /agent/operations
List operation routes, networks, supported composition steps and execution capabilities.
GET /agent/treasury
List Treasury workspaces, supported actions, Safe and Solana APIs, payment limits and native authorization.
POST /agent/treasury/solana/plan
Validate up to 500 distinct SOL or standard SPL recipients and return batches, exact atomic totals and preparation inputs.
POST /agent/treasury/solana/prepare
Simulate and verify the exact unsigned SOL or SPL payment batch before wallet approval.
POST /agent/transactions/solana/status
Check a Solana transaction signature for confirmation or on-chain failure. Unknown signatures remain unresolved.
POST /agent/swap/cow/quote
Request a CoW sell limit order, reconstructed EIP-712 signing payload, order UID and wallet handoff for submission.
POST /agent/swap/cow/approval
Prepare and verify an exact CoW token approval or reset before placing an order.
POST /agent/swap/cow/cancel-intent
Create a wallet-bound EIP-712 cancellation for one order UID. Return the native signed-cancellation endpoint.
POST /agent/earn/aave/prepare
Prepare Aave USDC supply, withdrawal or exact allowance on Ethereum or Base.
POST /agent/earn/morpho-vault/prepare
Prepare deposit or exit from the configured Morpho USDC vault. Amount is in USDC base units.
POST /agent/earn/morpho-blue/prepare
Prepare isolated lending, collateral, borrowing, repayment and supported bundled Morpho Blue operations.
POST /agent/earn/ethereum/prepare
Prepare Lido staking, wrapping or withdrawals and Sky Savings deposits or redemptions on Ethereum.
POST /agent/liquidity/concentrated/prepare
Prepare a concentrated liquidity position mint, increase, decrease or fee collection on a supported deployment.
POST /agent/liquidity/v4/prepare
Prepare eligible fixed-fee Uniswap v4 position actions against an ordered PoolKey with verified hooks.
POST /agent/liquidity/receipts/prepare
Prepare Curve NG receipt deposits or exits and supported Balancer withdrawals with exact pool token order.
POST /agent/derivatives/boros/prepare
Prepare Boros collateral, funding-rate orders, settlement or liquidity actions for the selected Arbitrum account.
POST /agent/perps/solana/order-intent
Build the exact native request body and single-use owner-signature message for Solana perps trading, collateral, account setup, cancellation and settlement. Deposit and withdrawal require the exact mint and spot market index. Omitting marketIndex on cancel-all selects every perp market in the chosen subaccount.
POST /agent/bridge/across/quote
Quote a native USDC transfer via Across. minOut is the owner’s base-unit minimum.
POST /agent/bridge/across/prepare
Prepare an Across approval or transfer with a verified SpokePool and minimum received. Native route has zero Bitpont fee.
POST /agent/bridge/cctp/burn
Prepare a native USDC approval or Circle CCTP burn using the selected fee cap. Native route has zero Bitpont fee.
POST /agent/bridge/cctp/mint
Prepare a Circle CCTP mint after verifying the source burn and Circle attestation.
POST /agent/bridge/cctp/status
Check a Circle transfer with its original networks, wallet, amount, fee cap and burn hash.
POST /agent/bridge/thorchain/quote
Quote native ETH to a mainnet Bitcoin P2WPKH address with THORChain. Amount is in wei. Bitcoin output uses satoshis.
POST /agent/bridge/thorchain/prepare
Prepare and verify an ETH to BTC transaction with a positive satoshi minimum. Native route has zero Bitpont fee.
POST /agent/operations/enso/quote
Quote an eligible same-chain ERC20 route via Enso.
POST /agent/operations/enso/prepare
Verify and prepare an eligible Enso approval or bounded same-chain route. Native route has zero Bitpont fee.
POST /agent/earn/pendle/prepare
Prepare an eligible Pendle PT, YT, maturity, liquidity or rewards action for the specified market and wallet.
POST /agent/options
Find Derive option underlyings and their Bitpont workspaces. Live contracts, strikes and wallet authorization use the venue.
POST /agent/earn/markets
Filter and paginate Earn markets by protocol, chain, category or text.
POST /agent/perps/markets
Read venue markets. Follow nextCursor when the adapter paginates.
POST /agent/perps/gmx/prepare
Prepare an eligible Arbitrum GMX increase, decrease, conditional order or cancellation. The owner must confirm eligibility.
POST /agent/services
Find product endpoints installed on this server by family, path or method.
POST /agent/swap/solana/quote
Quote exact-input Jupiter swaps using mint addresses and lamport or token base units.
POST /agent/swap/solana/prepare
Build unsigned Jupiter instructions against the previously reviewed minimum output.
POST /agent/earn/vault/prepare
Prepare Euler, Fluid lending, Yearn or Spark Savings operations against a verified vault.
POST /agent/earn/etherfi/prepare
Prepare ETH stake, receipt wrap or unwrap, withdrawal request or claim.
POST /agent/earn/sparklend/prepare
Prepare SparkLend supply, withdraw, borrow, repay and collateral choices.
POST /agent/earn/fluid-credit/prepare
Prepare an existing or new Fluid credit NFT position.
POST /agent/earn/llamalend/prepare
Prepare a verified Curve LlamaLend vault or loan action.
POST /agent/perps/ostium/prepare
Prepare Ostium orders, position changes, protective orders, cancellation and timeout recovery on Arbitrum.
GET /agent
Discover available actions, permissions, documentation and usage limits.
GET /agent/networks
List catalogue networks and their supported workspace families.
POST /agent/tokens
Page through exact token identities, units and supported intents.
POST /agent/protocols
Find supported protocol operations and their wallet workspaces.
POST /agent/route
Resolve exact token identities into a canonical Swap or Bridge ticket.
POST /agent/swap/quote
Compare live EVM swap quotes in base units. Inspect partnerPreparation before preparing.
POST /agent/swap/prepare
Prepare an unsigned, fee-checked KyberSwap transaction for the quoted wallet.
POST /agent/bridge/quote
Quote a direct deBridge transfer. Include both public wallet addresses for preparation.
POST /agent/bridge/prepare
Prepare the wallet-bound, unexpired direct route. Acknowledge any quoted warning after review.
POST /agent/bridge/status
Check delivery for a direct deBridge order and its source transaction.
Review, sign and verify
Check the network, wallet, recipient, spender, maximum input, minimum received, expiry and every fee. Protocol charges, gas, rent and Bitpont fees may be separate. Direct Earn and derivatives adapters retain the fee policy of their Bitpont workspace. See fees and execution.
Preparation produces unsigned instructions or a transaction. Rebuild the expected intent independently, simulate in the wallet, and request the owner’s approval for each signature. A token approval may require a later call to prepare the product action. For a bridge, check delivery after source confirmation. For an order, check fills or cancellation in its venue. Keep credentials, signatures and recovery phrases out of URLs and support messages.
Access, limits and retries
The agent endpoints accept keyless requests when public access is enabled. Use openWorkspace for keyless trading. High-volume partner keys use a server-side Bearer header. Private account reads and authenticated native actions retain their existing permissions. Use usage and the RateLimit response headers for the limits that apply to you.
On HTTP 429, wait for Retry-After. On an expired quote, request a fresh one and review the new terms. Partial data or a provider timeout is not confirmation of execution. Check the existing transaction or order before attempting another submission.
For a key or higher limits, email [email protected] with the operations you use and expected requests per minute.