PeerAgents

Quotes and Payees

The entry surface for pricing, payee details, and hash resolution.

Command Set

peer quote
peer payee register
peer payee resolve-hash

peer quote

Use this to discover fiat-to-USDC liquidity.

Primary flags:

FlagPurpose
--fromFiat currency code
--toDestination token symbol or address (default: USDC)
--amountExact fiat amount
--token-amountExact token amount to receive
--platformPayment platform filter
--recipient / --userWallet context for quote ownership
--destination-chain-idChain target
--quotes-to-returnLimit result set

Example:

peer quote --from USD --amount 100 --platform venmo --quotes-to-return 3

Use quote early in a workflow to determine whether liquidity exists before spending time on deposit or intent flows.

The SDK uses Curator’s /v3/quote API. Each accepted quote carries maker.offchainId, the maker’s payout identity; quote-derived payeeData contains that identity only. Telegram usernames and other maker metadata are not quote fields. Fetch maker details from /v2/makers when they are needed. A missing or blank payout identity makes a quote unusable.

Payee Commands

peer payee register

Registers payee details so later intent construction can reference stable hashed details.

peer payee register --processors venmo --deposit-data '[{"handle":"alice"}]'

peer payee resolve-hash

Converts a payee hash back into the underlying semantic identity when the SDK/service route supports it.

peer payee resolve-hash 42 <payment-method-hash>

These commands are useful when an agent needs to reconcile a previously observed payee hash with current operator input.

Agent Guidance

  • Start with quote when you need opportunity discovery.
  • Use payee register only when you are preparing an intent path that requires it.

On this page