Skip to main content

Status & history

Status by transaction id

Pass an EVM, TON, or Bitcoin TXID to retrieve a request's status.

const txId = '...';
const response = await sdk.teleportdao.getRequestStatusByTxId(txId);
console.log(response.state); // "Pending" | "Done" | "Failed"
warning

There may be a short delay after broadcasting before the request becomes queryable. While state is Pending, sourceTransaction may be null and fee fields may be 0.

Account history

Fetch requests for one or more Bitcoin/EVM addresses.

const addresses = ['0x...', 'bc1...'];

const response = await sdk.teleportdao.getRequests(addresses, {
type: 'WrapAndSwap', // Wrap | Unwrap | WrapAndSwap | SwapAndUnwrap
tokenType: 'BTC', // BTC
filter: 'done', // all | done | pending (default: done)
limit: 10,
offset: 0,
order: 'desc',
});

// Or fetch everything matching the config:
const all = await sdk.teleportdao.getAllRequests({ filter: 'all' });

Waiting requests

Requests in the Waiting state are not included in getRequests. Fetch them for an EVM address:

const waiting = await sdk.teleportdao.getWaitingRequests(evmAddress);

State vs. status

  • state — high-level lifecycle: Pending, Done, or Failed.
  • status — granular progress: NotProcessed, Pending, Confirmed, Submitted, and terminal ExchangeFailed / Failed / Withdrawn (refund states).

A full field-by-field walkthrough of a request record lives in the API reference (Request schema).

REST equivalents

SDK methodEndpoint
getRequestStatusByTxIdGET /api/v2/teleswap/requests/tx/{txId}
getRequests / getAllRequestsGET /api/v2/teleswap/requests
getWaitingRequestsGET /api/v1/teleswap/cross-chain/waiting-request/{address}