Skip to main content
GET
Get transfer
Use this endpoint to poll a transfer after you create it with POST /v1/transfers. Pass the transferId query parameter from the create response. The response includes both amount as a decimal USDC string and amountBaseUnits as the exact 6-decimal base-unit string.

Authorizations

Authorization
string
header
required

API key in the format dk_live_.... Pass as Authorization: Bearer dk_live_...

Query Parameters

transferId
string
required

Transfer ID returned by POST /v1/transfers

Response

Transfer status

id
string
required
workflowId
string | null
required
source
enum<string>
required
Available options:
evm,
polymarket_safe,
hypercore_spot,
hypercore_perps
destination
enum<string>
required
Available options:
evm,
polymarket_safe,
hypercore_spot,
hypercore_perps
sourceChain
enum<string> | null
required

Resolved source chain when the transfer path uses one

Available options:
arbitrum,
polygon
amount
string
required

Amount as a decimal USDC string

Example:

"1.25"

amountBaseUnits
string
required

Amount as the exact 6-decimal base-unit string

Example:

"1250000"

status
enum<string>
required
Available options:
processing,
completed,
failed
triggeredBy
enum<string>
required
Available options:
user,
auto
providerState
object | null
required

Provider-specific execution details for debugging and status reporting

txHashes
string[]
required
errorMessage
string | null
required
createdAt
number
required
updatedAt
number
required
completedAt
number | null
required