Execution

Execute a pre-signed order on Hyperliquid

Forwards a pre-signed EIP-712 order to Hyperliquid. Requires prior execution-ready analyze-strategy call within 60 seconds for risk-increasing orders (parameter-bound research gate). Scout signed capacity or x402 overage applies; paid capacity never creates authority. FarmDash may receive routing compensation from supported venues. Risk guardrails enforced server-side. nonce, expiresAt, and intentHash are required for request-scoped expiry and auditability. expiresAt is forwarded as venue expiresAfter. market_ioc is a signed, price-protected IOC limit order with a live 100 bps adverse-price cap, never an unbounded market order. It distinguishes full, partial, and zero fill; an IOC resting response is unknown/inconsistent. Venue nonce authority is network + signer + nonce across account and vault contexts. Durable replay control fails closed before submission. The signed order action discloses FarmDash builder f=1, which means 0.1 bp (0.001%) of filled notional—not 1 bp. Resting/rejected/unfilled notional is not fee-bearing volume. WARNING: Real market actions can cause financial loss. USER_SIGNED requires fresh manual approval for each order/cancel. BOUNDED_AUTONOMOUS permits local agent signing without per-order confirmation only under a valid explicit owner-signed futures grant, authenticated session, venue delegation and all applicable gates. Futures bounded autonomy remains preparation_only until the production canary passes.

post/v1/agent/futures/execute-order

Request

  • Base URL: https://www.farmdash.one/api
  • URL: https://www.farmdash.one/api/v1/agent/futures/execute-order
  • Auth: HTTP bearer

Headers

X-FarmDash-Session-Tokenstring

Session capability for BOUNDED_AUTONOMOUS; does not grant venue signing authority

X-ClawHub-Skillstring
Example:farmdash-signal-architect

ClawHub skill attribution. An installed FarmDash skill sends its canonical skill slug (e.g. farmdash-signal-architect) on every FarmDash API request so anonymous Scout usage can be attributed to the skill that drove it. Optional and analytics-only: absence never blocks a request, and malformed values are ignored. This is a skill identity, never a wallet address, API key, or user ID.

Request body

executionTrialIdstring

Inherited durable futures lifecycle. Accepted orders commit; ambiguous submission stays held pending direct venue reconciliation.

accountAddressstring
executionMode'USER_SIGNED' | 'BOUNDED_AUTONOMOUS'

USER_SIGNED is preserved for unenrolled signers. Owner registration permanently enrolls the API wallet on its network across accounts, including after expiry/revocation; stripping mode/session fields cannot bypass bounded policy. Bounded dispatch returns nonretryable bounded_futures_preparation_only while rollout is not operational.

grantIdstring

Required for BOUNDED_AUTONOMOUS

sessionIdstring

Required for BOUNDED_AUTONOMOUS; binds session agent separately from API wallet

sessionTokenstring

Session capability; alternatively X-FarmDash-Session-Token header

agentAddressstring required
coinstring required
isBuyboolean required
sizestring required
pricestring required
orderType'limit_gtc' | 'limit_ioc' | 'limit_alo' | 'market_ioc' | 'stop_loss' | 'take_profit' required

market_ioc is a signed, price-protected IOC limit order with a live 100 bps adverse-price cap, never an unbounded market order.

reduceOnlyboolean
signedActionobject

If supplied, must contain the signed FarmDash builder term { b: treasury, f: 1 }; f is tenths of a basis point.

nonceinteger required
expiresAtinteger required
intentHashstring required

Response

Order execution result

okboolean
state'fully_filled' | 'partially_filled' | 'zero_fill' | 'resting_unfilled' | 'rejected' | 'unknown'
intentHashstring
expiresAtinteger
timestampinteger
errorstring

Example response

{
  "order": {
    "builderFee": {
      "venueUnitsTenthsBps": 1,
      "basisPoints": 0.1,
      "percent": 0.001
    }
  }
}

Changes

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