---
title: "Get a provider-neutral market estimate"
method: GET
path: "/v1/agent/market-estimate"
tags: ["Swap"]
---

# Get a provider-neutral market estimate

`GET /v1/agent/market-estimate`

## Request

- Base URL: `https://www.farmdash.one/api`
- URL: `https://www.farmdash.one/api/v1/agent/market-estimate`
- Auth: none declared

Discovery intelligence for browsing, previews, polling, and walletless
exploration. Returns an explicitly labelled market_estimate (reference
price, approximate output, server fee tier, route compatibility,
freshness) WITHOUT calling 0x, LI.FI, or Relay trading APIs. Never
executable, never attributed, never liquidity-confirmed. For
execution, POST /v1/agent/quote-intent.

## Query parameters

- `fromChainId` 1 | 10 | 137 | 8453 | 42161 | 59144, required
- `toChainId` 1 | 10 | 137 | 8453 | 42161 | 59144, required
- `fromToken` string, required
- `toToken` string, required
- `fromAmount` string, required

## Headers

- `X-ClawHub-Skill` string

## Response `200`

Market estimate

- MarketEstimateResponse
  - `quoteKind` 'market_estimate', required
  - `continuation` ExecutionContinuation
    - `schema` 'farmdash.execution-continuation.v1', required
    - `continuation_id` string, uuid, required
    - `source` object, required
      - `type` 'market_estimate' | 'solana_preview' | 'futures_analysis', required
      - `ref` string, required
    - `execution_domain` 'spot' | 'solana' | 'futures', required
    - `network` string, required
    - `protocol_id` string, nullable, required
    - `assets` object[], required
      - `namespace` 'eip155' | 'solana' | 'hyperliquid', required
      - `network` string, required
      - `identifier` string, required
      - `symbol` string
      - `kind` 'native' | 'wrapped_native' | 'token' | 'market', required
      - `decimals` integer
    - `action_kind` 'swap' | 'prepare_order', required
    - `lifecycle_id` string, uuid, required
    - `trail_id` string, nullable, required
    - `next_operation` ExecutionContinuationNextOperation, required
      - `method` 'POST', required
      - `endpoint` '/api/v1/agent/quote-intent' | '/api/agents/solana-swap' | '/api/agents/futures/prepare-order' | '/api/v1/agent/futures/prepare-order', required
      - `parameters` object, required
      - `required_fields` string[], required
    - `available_execution_modes` string[], required
    - `authority` 'NOT_GRANTED', required
    - `prerequisites` string[], required
    - `scout_trial` object, required
      - `exists` true, required
      - `domain` 'spot' | 'futures', required
      - `daily_limit` integer, required
      - `remaining` unknown, required
      - `status` 'unknown' | 'evaluation_required', required
      - `after_exhaustion` 'authoritative_admission', required
    - `expires_at` string, date-time, required
  - `next_operation` ExecutionContinuationNextOperation
    - `method` 'POST', required
    - `endpoint` '/api/v1/agent/quote-intent' | '/api/agents/solana-swap' | '/api/agents/futures/prepare-order' | '/api/v1/agent/futures/prepare-order', required
    - `parameters` object, required
    - `required_fields` string[], required
  - `executionReady` false, required
  - `liquidityConfirmed` false, required
  - `providerAttribution` string, nullable
  - `referencePriceUsd` number, nullable
  - `estimatedInputUsd` number, nullable
  - `estimatedOutputUsd` number, nullable
  - `priceUnknown` boolean, required
  - `feeTierBps` integer, required
  - `volumeUnknown` boolean, required
  - `compatibleProviders` string[], required
  - `routeSupported` boolean, required
  - `liquidityUsd` number, nullable
  - `volume24hUsd` number, nullable
  - `sources` string[], required
  - `confidence` 'high' | 'medium' | 'low', required
  - `observedAt` string, required
  - `cached` boolean, required
  - `stale` boolean, required
  - `attempts` object[]
  - `warnings` string[]
  - `unsigned` true, required
  - `broadcast_by_farmdash` false, required
  - `simulation_required` boolean
  - `simulate_url` string
  - `execution_boundary` object, required
    - `state` string
    - `simulation_required` boolean
    - `local_signature_required` boolean
    - `farmdash_broadcasts_transaction` boolean
  - `note` string, required

## Other responses

- `400`: Invalid parameters
- `402`: Free-tier limit exceeded — x402 payment required
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/farmdash/apis/farmdash-agent-api.md) · [All operations](https://skmtc.dev/farmdash/apis/farmdash-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/farmdash/apis/farmdash-agent-api/revisions/96310281f58c?raw)