API Specifications

Specifications to interact with Fynd server

GET /v1/health - Health check endpoint.

get

Returns the current health status of the service.

Responses

200

Service healthy

application/json

Health check response.

healthybooleanRequired

Whether the service is healthy.

Example: true

last_update_msinteger · int64Required

Time since last market update in milliseconds.

Example: 1250

num_solver_poolsintegerRequired

Number of active solver pools.

Example: 2

503

Data stale

application/json

get

/v1/health

HTTPcURLJavaScriptPython

GET /v1/health HTTP/1.1
Accept: */*

{
  "healthy": true,
  "last_update_ms": 1250,
  "num_solver_pools": 2
}

POST /v1/solve - Submit a solve request.

post

Accepts a SolutionRequest and returns a Solution with the best routes found, or an error if the request could not be filled.

Errors

• 400 Bad Request: Invalid request format

• 422 Unprocessable Entity: No routes found

• 503 Service Unavailable: Queue full or service overloaded

• 504 Gateway Timeout: Solve timeout

Body

application/json

Request to solve one or more swap orders.

Responses

200

Solve completed

application/json

Complete solution for a [SolutionRequest].

Contains a solution for each order in the request, along with aggregate gas estimates and timing information.

solve_time_msinteger · int64Required

Time taken to compute this solution, in milliseconds.

Example: 12

total_gas_estimatestringRequired

Total estimated gas for executing all swaps (as decimal string).

Example: 150000

400

Invalid request

application/json

422

No route found

application/json

503

Service unavailable

application/json

504

Solve timeout

application/json

post

/v1/solve

HTTPcURLJavaScriptPython

POST /v1/solve HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 352

{
  "options": {
    "max_gas": "500000",
    "min_responses": null,
    "timeout_ms": 2000
  },
  "orders": [
    {
      "amount": "1000000000000000000",
      "receiver": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "sender": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "side": "sell",
      "token_in": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
      "token_out": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
    }
  ]
}

{
  "orders": [
    {
      "amount_in": "1000000000000000000",
      "amount_out": "3500000000",
      "amount_out_net_gas": "3498000000",
      "block": {
        "hash": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcd",
        "number": 21000000,
        "timestamp": 1730000000
      },
      "gas_estimate": "150000",
      "order_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "price_impact_bps": null,
      "route": null,
      "status": "success"
    }
  ],
  "solve_time_ms": 12,
  "total_gas_estimate": "150000"
}