Skip to main content
POST
/
api
/
v1
/
ai
/
trades
/
quote
/
refresh
Refresh trade quote
curl --request POST \
  --url https://mcp.echozero.app/api/v1/ai/trades/quote/refresh \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "confirmationId": "conf_abc123"
}
'
{
  "success": true,
  "data": {
    "confirmationId": "<string>",
    "title": "<string>",
    "description": "<string>",
    "quote": {
      "quoteId": "<string>",
      "inputToken": {
        "address": "<string>",
        "symbol": "<string>",
        "decimals": 123,
        "name": "<string>",
        "logoUri": "<string>",
        "priceUsd": 123,
        "priceChange24h": 123
      },
      "outputToken": {
        "address": "<string>",
        "symbol": "<string>",
        "decimals": 123,
        "name": "<string>",
        "logoUri": "<string>",
        "priceUsd": 123,
        "priceChange24h": 123
      },
      "inputAmount": "<string>",
      "outputAmount": "<string>",
      "inputAmountUsd": 123,
      "outputAmountUsd": 123,
      "priceImpactPct": 123,
      "totalFeesUsd": 123,
      "exchangeRate": 123,
      "slippageBps": 123,
      "expiresAt": "2023-11-07T05:31:56Z"
    },
    "createdAt": "2023-11-07T05:31:56Z",
    "isVirtual": true,
    "warning": "<string>",
    "agentAnalysis": "<string>",
    "confirmedAt": "2023-11-07T05:31:56Z",
    "transactionHash": "<string>",
    "botId": "<string>"
  }
}

Authorizations

x-api-key
string
header
required

Headers

x-signature
string

HMAC-SHA256 signature: HMAC-SHA256(secretKey, timestamp + METHOD + path + body). Optional -- when omitted, HMAC verification is skipped.

x-timestamp
string

Request timestamp in epoch milliseconds. Required when x-signature is provided. Rejected if drift exceeds 5 minutes.

Body

application/json
confirmationId
string
required

Trade confirmation id to refresh

Response

Updated confirmation with fresh quote.

success
boolean
required
Example:

true

data
object
required

Endpoint-specific payload