Poll for Status

Track a payment from deposit to completion.

Status lifecycle

AWAITING_DEPOSIT → DEPOSIT_RECEIVED → EXECUTING → COMPLETED
                                               ↘ FAILED
AWAITING_DEPOSIT → EXPIRED

Status	Meaning	Action
AWAITING_DEPOSIT	No on-chain activity yet	Keep polling
DEPOSIT_RECEIVED	Deposit seen on source chain	Keep polling
EXECUTING	Cross-chain swap in progress	Keep polling
COMPLETED	Funds delivered to recipient	Fulfil order
EXPIRED	Quote timed out (5 min window)	Show retry UI
FAILED	Execution failed	Show error

Request

curl --location 'https://godirekt.xyz/api/status/5af8532c-5bf4-45c2-b099-1b36e96e91a3' \
  --header 'x-api-key: YOUR_API_KEY'

Response

{
  "success": true,
  "quoteId": "5af8532c-5bf4-45c2-b099-1b36e96e91a3",
  "status": "AWAITING_DEPOSIT",
  "createdAt": 1780010048,
  "expiresAt": 1780010348,
  "depositAddress": "0x7fa491b5765b5eea6b113a9121c311d780f8c61b",
  "deposit": null,
  "gas": null,
  "execution": {
    "startedAt": null,
    "completedAt": null,
    "outputTxHash": null,
    "steps": []
  },
  "route": {
    "from": { "chainId": 8453, "chainName": "Base", "token": "0x000...000" },
    "to": { "chainId": 56, "chainName": "BNB Chain", "token": "0x000...000" },
    "amount": "1000000000000000000",
    "recipient": "0xa110c77fa4b07ab601e63ecd65e99ddb8f1df6ec"
  },
  "error": null
}

execution.outputTxHash is populated once the swap executes on the destination chain. Use it to link to a block explorer.

Polling implementation

async function pollStatus(quoteId, apiKey) {
  const res = await fetch(
    `https://godirekt.xyz/api/status/${quoteId}`,
    { headers: { Authorization: `Bearer ${apiKey}` } }
  );
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  return res.json();
}

// Poll every 7 seconds
const interval = setInterval(async () => {
  const data = await pollStatus(quoteId, apiKey);

  if (data.status === 'COMPLETED') {
    clearInterval(interval);
    fulfilOrder(data.execution.outputTxHash);
  } else if (data.status === 'EXPIRED' || data.status === 'FAILED') {
    clearInterval(interval);
    showError(data.error);
  }
}, 7000);