Pre-compute and persist engine data for a wallet

POST

/api/wallets/{address}/precompute

curl --request POST \
  --url 'https://api.qeychain.xyz/api/wallets/example/precompute?force=false'

• Production

Fire-and-forget: returns immediately with 202 Accepted while the engine runs in the background. Call this from an external app so that when the user later opens the dashboard, data loads instantly from DB (~1s instead of ~14s). If data is already fresh, returns 200 with no background work.

Parameters

Path Parameters

address

required

Address

string

Query Parameters

owned_wallets

Any of:

Array<string>

Array<string>

null

null

All wallet addresses owned by the user

force

Force

Force recompute even if DB already has fresh data.

boolean

Force recompute even if DB already has fresh data.

Responses

200

Successful Response

Media typeapplication/json

Example^generated

example

400

Bad Request

Media typeapplication/json

ErrorResponse

Standard error response.

object

detail

required

Detail

Error message

string

error_code

Any of:

string

string

null

null

Example^generated

{
  "detail": "example",
  "error_code": "example"
}

404

Not Found

Media typeapplication/json

ErrorResponse

Standard error response.

object

detail

required

Detail

Error message

string

error_code

Any of:

string

string

null

null

Example^generated

{
  "detail": "example",
  "error_code": "example"
}

422

Validation Error

Media typeapplication/json

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

Example^generated

{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}

500

Internal Server Error

Media typeapplication/json

ErrorResponse

Standard error response.

object

detail

required

Detail

Error message

string

error_code

Any of:

string

string

null

null

Example^generated

{
  "detail": "example",
  "error_code": "example"
}