Overview

The /v1/mee/quote endpoint takes instructions generated from other endpoints (intent, intent-simple, build, or compose) and returns a quote with fee details and payloads to sign. Users can optionally specify a fee token to pay for gas in any of 10,000+ supported ERC-20 tokens.

How It Works

The quote endpoint:
  1. Accepts instructions - Takes the instruction array from previous endpoint responses
  2. Calculates fees - Determines gas costs and orchestration fees
  3. Supports fee tokens - Optional feeToken parameter enables gas payment in 10,000+ ERC-20 tokens
  4. Returns signable payloads - Provides the data that needs to be signed for execution

Request Structure

POST /v1/mee/quote

Request Body

ParameterTypeDescription
typestringExecution mode: smart-account, eoa, or eoa-7702
fromAddressstringEVM wallet address of the user
instructionsarrayInstructions array from previous endpoints
feeTokenobjectOptional: Token for gas payment (if not specified, sponsorship will be used)
fundingTokensarrayOptional: Tokens to deposit for execution
authorizationobjectOptional: EIP-7702 authorization for EOA delegation
lowerBoundTimestampnumberOptional: Lower bound timestamp for execution
upperBoundTimestampnumberOptional: Upper bound timestamp for execution

Fee Token Configuration

The feeToken parameter allows gas payment in ERC-20 tokens:
"feeToken": {
  "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  "chainId": 1
}

Example Request

curl -X POST https://api.biconomy.io/v1/mee/quote \
  -H "Content-Type: application/json" \
  -d '{
    "type": "smart-account",
    "fromAddress": "0x0a7C906832544293a6018bA25280c7f7b0Bbf120",
    "instructions": [
      {
        "calls": [
          {
            "to": "0x1111111254EEB25477B68fb85Ed929f73A960582",
            "value": "0",
            "functionSig": "transfer(address,uint256)",
            "inputParams": [...],
            "outputParams": [...]
          }
        ],
        "chainId": 1,
        "isComposable": true
      }
    ],
    "feeToken": {
      "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "chainId": 1
    }
  }'

Response

Returns a quote with fee details and payloads to sign:
{
  "fromAddress": "0x1234567890abcdef1234567890abcdef12345678",
  "fee": {
    "amount": "10000000000000000",
    "token": "0x0000000000000000000000000000000000000000",
    "chainId": 8453
  },
  "quoteType": "permit",
  "quote": {
    "hash": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdef",
    "node": "0x9876543210abcdef9876543210abcdef98765432",
    "commitment": "0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef",
    "paymentInfo": {...},
    "userOps": [...],
    "fundingTokens": [...]
  },
  "payloadToSign": [
    {
      "signablePayload": {...},
      "metadata": {...}
    }
  ]
}

Quote Types

  • permit - EIP-712 permit signature required
  • onchain - Direct on-chain transaction
  • simple - Simple message signature

Workflow

  1. Generate instructions using intent, intent-simple, build, or compose endpoints
  2. Pass instructions to the quote endpoint
  3. Optionally specify a feeToken to pay gas in ERC-20 tokens
  4. Receive quote with payloads to sign
  5. Sign the payloads and submit to the execute endpoint

Gas Payment Options

  • Default: If no feeToken specified, sponsorship will be used
  • ERC-20 Payment: Specify any of 10,000+ supported tokens as feeToken
  • Native Token: Use zero address (0x0000...0000) for native token payment