Agent programmatic purchase (USDC on Base + mandate-aware)

Dual-mode purchase endpoint. Returns one of: instant_download (free skill), instant_purchase (paid skill with valid mandate + verified USDC tx), direct_purchase (paid skill with verified USDC tx, no mandate), requires_payment (mandate valid but no txHash yet), requires_human_approval (no mandate and no payment — agent must request approval).

post/api/agent-purchase

Request

  • Base URL: https://marketnow.site
  • URL: https://marketnow.site/api/agent-purchase
  • Auth: none declared

Request body

skillIdstring required
walletAddressstring

agent's wallet, required for paid

txHashstring

USDC Transfer on Base, required for paid

mandateIdstring

optional, enables autonomous purchase within pre-approved limit

agentIdstring

optional, for tracking

Response

Purchase response — check the 'mode' field to determine next step

successboolean
mode'instant_download' | 'instant_purchase' | 'direct_purchase' | 'requires_payment' | 'requires_human_approval'
licenseobject
system_promptstring
installstring
mandateobject
optionsobject

Changes

No recorded changes to this operation across all 1 revision of this API.