Get Transfer

get

Retrieves the current state of a transfer.

Use this endpoint to check the status of a transfer, view deposit details, and track progress.

Path parameters

idstringRequired

The transfer ID returned from create transfer

Example: txfr_1a2b3c4d5e6f

Responses

200

Transfer retrieved successfully

application/json

idstringRequired

Unique transfer identifier

Example: txfr_1a2b3c4d5e6f

createdAtstring · date-timeRequired

Timestamp when the transfer was created

Example: 2024-01-15T10:30:00Z

updatedAtstring · date-timeRequired

Timestamp when the transfer was last updated

Example: 2024-01-15T10:32:00Z

statusstring · enumRequired

Current status of the transfer session

Example: waiting_for_depositPossible values:

originTokenstringOptional

The origin token in chain:address format

Example: base:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

originAmountstringOptional

The expected origin amount in smallest units

Example: 1050000

destinationTokenstringOptional

The destination token in chain:address format

Example: solana:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

destinationAmountstringOptional

The target destination amount in smallest units. Estimated for best-effort, guaranteed for exact-out.

Example: 1000000

recipientstringOptional

The recipient address in chain:address format

Example: solana:7aLBCrbn4jDNSxLLJYRRnKbkqA5cuaeaAzn74xS7eKPD

depositAddressstringOptional

The deposit address in chain:address format

Example: base:0x4D9A6F3c7B2E1a8D5C0F9e7B6A4d2E8c1F3a5B7D

depositAcceptedTokenstringOptional

The deposited token in chain:address format. Populated when deposit is detected.

Example: base:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

depositAcceptedAmountstringOptional

The amount accepted for processing in smallest units. Populated when deposit is detected.

Example: 1050000

depositAcceptedAtstring · date-timeOptional

Timestamp when the deposit was accepted. Populated when deposit is detected.

Example: 2024-01-15T10:31:00Z

depositSenderstringOptional

The address that sent the deposit in chain:address format. Populated when deposit is detected.

Example: base:0x1234567890abcdef1234567890abcdef12345678

depositTxHashstringOptional

The transaction hash of the deposit in chain:hash format. Populated when deposit is detected.

Example: base:0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890

fillAmountstringOptional

The actual delivered amount in smallest units. Populated when transfer completes.

Example: 998000

fillAtstring · date-timeOptional

Timestamp when the fill was executed. Populated when transfer completes.

Example: 2024-01-15T10:33:00Z

fillTxHashstringOptional

The transaction hash of the fill in chain:hash format. Populated when transfer completes.

Example: solana:abc123def456ghi789jkl012mno345pqr678stu901vwx234yz

executionModestring · enumOptional

The execution mode for this transfer

Example: best_effortPossible values:

etaSecondsintegerOptional

Estimated time to completion in seconds

Example: 120

feeUsdstringOptional

Total fee in USD

Example: 1.75

feeBpsstringOptional

Fee in basis points (100 bps = 1%)

Example: 25

get

/transfers/{id}

HTTPcURLJavaScriptPython

GET /transfers/{id} HTTP/1.1
Accept: */*

200

Transfer retrieved successfully

{
  "id": "txfr_1a2b3c4d5e6f",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:32:00Z",
  "status": "waiting_for_deposit",
  "originToken": "base:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "originAmount": "1050000",
  "destinationToken": "solana:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "destinationAmount": "1000000",
  "recipient": "solana:7aLBCrbn4jDNSxLLJYRRnKbkqA5cuaeaAzn74xS7eKPD",
  "depositAddress": "base:0x4D9A6F3c7B2E1a8D5C0F9e7B6A4d2E8c1F3a5B7D",
  "depositAcceptedToken": "base:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "depositAcceptedAmount": "1050000",
  "depositAcceptedAt": "2024-01-15T10:31:00Z",
  "depositSender": "base:0x1234567890abcdef1234567890abcdef12345678",
  "depositTxHash": "base:0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
  "fillAmount": "998000",
  "fillAt": "2024-01-15T10:33:00Z",
  "fillTxHash": "solana:abc123def456ghi789jkl012mno345pqr678stu901vwx234yz",
  "executionMode": "best_effort",
  "etaSeconds": 120,
  "feeUsd": "1.75",
  "feeBps": "25"
}