Skip to main content
GET
/
workflows
/
getStatus
Get Workflow Status
curl --request GET \
  --url https://api-v2.swaps.xyz/api/workflows/getStatus \
  --header 'x-api-key: <api-key>'
{
  "txId": "0x36f51092bdfb6f9793fefd9b2d27529fbf7362b48ded9acb7fa4cc7aea03aeca",
  "status": "success",
  "operation": "placeOrder",
  "timestamp": 1765593597,
  "name": "polymarket",
  "data": {
    "userId": "0x0797bfec6d2d4f733d461bbee8125805e9e9c892",
    "orderRequest": {
      "tokenID": "110902308091723190012269532299497167125504426554890434343419495764557291673806",
      "feeRateBps": 0,
      "slippage": 100,
      "negRisk": true,
      "amount": 5,
      "price": 0.021,
      "size": 5
    },
    "orderResponse": {
      "id": "0xbd2f3c625c1f6f918a74e8645c3afee9e8f2c5adf91f178efa5e1b65f74fb489",
      "status": "MATCHED",
      "owner": "258f7485-b93f-52e5-2327-a53c49a299c1",
      "maker_address": "0xBEDcAD563ddf52391573a016Bc5EC7A334Eec756",
      "market": "0xb050c89e1e5738c79e117d28da1f057ac2f193511aab87a01b517b466c7265dc",
      "asset_id": "110902308091723190012269532299497167125504426554890434343419495764557291673806",
      "original_size": "5",
      "size_matched": "0",
      "price": "0.02",
      "outcome": "No",
      "expiration": "1763996360",
      "order_type": "GTD",
      "associate_trades": [
        "<string>"
      ],
      "created_at": 1763996291
    },
    "relayTx": {
      "txHash": "<string>",
      "status": "<string>"
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.swaps.xyz/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Limited demo key for API Reference: 5c951bc81da566bbd030ba8e20724063.

Query Parameters

​
txId
string
required

Transaction ID from /getAction request

Example:

"0x1b121f30eeddfc1ee3eeb491c02be6c4b676b0ac0ac3e309fa25f010172c5af4"

Response

Workflow status response

​
txId
string
required

Transaction ID

Example:

"0x36f51092bdfb6f9793fefd9b2d27529fbf7362b48ded9acb7fa4cc7aea03aeca"

​
status
enum<string>
required

Workflow status

Available options:
success,
failed,
pending
Example:

"success"

​
operation
string
required

Operation type

Example:

"placeOrder"

​
timestamp
integer
required

Unix timestamp when workflow was executed

Example:

1765593597

​
name
string
required

Workflow name

Example:

"polymarket"

​
data
Polymarket Data · object
required

Workflow-specific data