# Bitpont Agent Workflows | Assets, Quotes and Market Views

Follow worked examples for exact amounts, route selection, market views, Treasury payment planning and product-to-product Operations.

Canonical: https://www.bitpont.com/developers/agent-workflows/


## Check a multi-tool workflow

Call bitpont_checkWorkflow or POST to /api/v1/agent/workflow/check with up to twelve calls in order. Each call has a tool name and input object. Inspect the returned field-level issues, the transport and the workspace requirement. This checks the input schemas and calls no provider. Recheck live fees, balances and approvals when preparing an actual trade. Follow the workflow validation example.

Server-side JavaScript
```
import {BitpontClient} from './bitpont-client.mjs';
const client = new BitpontClient({publicAccess:true});
const result = await client.view('bridge-assets', {
  sourceChain: 'evm:1', destinationChain: 'evm:8453', symbol: 'USDC'
});
for (const row of result.results) console.log(row.id, row.state, row.pagination);
```

## Choose a task

Call bitpont_recipes with an optional product ID. Open the chosen task with bitpont_recipe. Each result has a concrete start.tool and start.input, the later steps, their access requirements and the outcome to verify. A recipe describes a sequence and only its first request has ready-to-use inputs.

## Resolve identity and amount

Use bitpont_findAssets to find an asset by name, symbol or address. A symbol can resolve to multiple contracts. Use bitpont_resolvePair to see both sides and select an exact address when it returns ambiguous. Use bitpont_convertAmount on that network and address before requesting a quote. Pass amounts as strings to preserve precision.

## Inspect markets and positions

Start with bitpont_viewPerpetualMarkets for Hyperliquid, GMX and Ostium. bitpont_viewLendingAccount combines a reserve read and the specified wallet’s Aave and Morpho vault positions. Each view costs one unit per underlying read. Results retain provider identity, observation time, availability and pagination. Compare like units and timestamps.

## Plan payments

Open the safe-payments or solana-payments recipe. Supply the actual wallet, network and recipient list to the planning operation. For a Safe, record the proposal hash and collect the owner approvals. For Solana, persist the run ID, batch number and exact transaction signature. Resume from the first batch with a verified unpaid outcome.

## Hand off an operation

For a Base USDC move from Aave to Morpho, prepare the human-readable amount with bitpont_workflowDraft. Show the owner the returned steps, costs and review URL. A withdrawal and a deposit have separate results. Use the next step only after the preceding amount and settlement are known.

[Look up input fields by tool](/help/ai-agents/#agent-explorer).

## Show fees before owner review

For a fee-bearing EVM swap, preserve the quote ID, wallet and selected route, then display the configured fee in the prepared transaction. On the supported deBridge path, compare fee.expectedBaseUnits, the source asset, recipient and minimum output with the original quote. The preparation can reject a changed fee or expired quote. A quoted fee, an unsigned transaction and a received fee are different stages. Keep the transaction hash for reconciliation. [Read the fee policy](/fees/) and [inspect the swap example](/developers/quotes/).

## From fee quote to referral reward

Identify the bridge provider first. The direct DLN quote exposes the Bitpont rate, source asset, expected base-unit fee and source-chain recipient. Preparation rechecks those terms. Follow the order ID to the source settlement or manual withdrawal. Only a matching finalized credit proves collection. Bitpont’s partner ledger separately checks an accepted Solana invitation and an eligible fee source. Direct deBridge receipts do not create automatic partner rewards.

On Solana Jupiter swaps, public quote and unsigned preparation expose a typed fee. The public transaction endpoint returns an unsigned Jupiter transaction. To submit through Bitpont, reuse the private workspace and sign the reviewed ticket with the sending wallet. API access, collection evidence and affiliate eligibility are separate checks. [Fee policy](/fees/) · [Partner coverage](/referrals/#reward-eligibility).

## Resume a task across Portfolio and MCP

For swap → deposit, withdraw → swap and bridge → deposit, start in [Portfolio Activity](/portfolio/activity/#portfolioFinancialTasks) or call taskCreate with a persistent request UUID and a private workspace. Save data.task.id as taskId. Read taskStatus before preparing the next step. Each wallet signature authorizes an individual transaction. Preserve the native gas reserve when sizing the remaining deposit.

For the Base example below, obtain a supported WETH vault and its protocol from the live connected vault directory. Load the wallet, workspace and request UUID from your application. Set the minimum output from the reviewed quote. The example prepares a plan for 100 USDC and reserves 0.002 ETH for gas.

```
const {data} = await client.agent("taskCreate", {
  requestId, kind: "swap-deposit", wallet, network: "base",
  inputToken: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  outputToken: "0x0000000000000000000000000000000000000000",
  protocol, vault, amount: "100000000", gasReserve: "2000000000000000",
  minOutput: reviewedMinimumWei, slippageBps: 50
});
const taskId = data.task.id;
```
Recover the task with taskList in the same workspace. Resume using the step and attempt returned in task status. After a bridge submission, wait for evidence of the intended token reaching the intended destination wallet. An unavailable provider or unknown submitted transaction needs recovery before a further submission. [Follow the task from first signature to recovery](/help/ai-agents/resumable-portfolio-tasks/).

## Use a token lookup in a second read

For a Base swap, look up the exact source token before converting a display amount. Call batchTools for the eligible reads and output paths. With checkReadBatch, bind /route/source/address from a preceding resolvePair call to the address input of convertAmount. A successful check returns valid: true. Submit the same calls to runReadBatch and inspect each item in results. A blocked dependency carries status 424. Resolve any ambiguous token and rerun the reads before requesting a quote.

[Copy the Base lookup and conversion example](/help/ai-agents/batch-agent-reads/) · [Resolve a pair and request a live quote](/help/ai-agents/find-swap-and-bridge-quotes/)

## Compare a yield assumption with an executable offering

Use earnCompareOpportunities to review provider-reported rates and freshness. Use earnYieldScenario with the principal, assumed APY, holding period and round-trip cost to compare scenarios in the same token units. Resolve the intended asset with earnOfferingSearch. Select the connected offering and its deposit or withdrawal adapter before requesting wallet review.

[Work through a 90-day USDC scenario](/help/ai-agents/compare-earn-yield-and-costs/) · [Check a lending withdrawal on Base or Ethereum](/help/ai-agents/check-lending-withdrawal-capacity/)


