`deposit-address`

Returns the address the user (or a later tokenSend) must pay for one source → destination route. The same path is used for deposits into TxFlow and for withdrawals out of TxFlow; only src_chain / dst_chain swap.

POST/api/v1/bridge/deposit-address

One-time deposit / peg address for a single source → destination route

Request body

channel_idintegerrequired

`0` for TxFlow. Do not mix with other products.

dst_addressstring · addressrequired

Credit address on `dst_chain` (TxFlow user for deposits; external wallet for withdraws).

dst_chainstringrequired

Destination chain key.

src_chainstringrequired

Source [`chain`](/api/txrelay/networks) key.

symbolstringrequired

Token `symbol` from networks (not `display_symbol`).

Request example

curl -X POST https://devnet-bridge.txflow.net/api/v1/bridge/deposit-address \
  -H "Content-Type: application/json" \
  -d '{
  "channel_id": 0,
  "src_chain": "arbitrum",
  "dst_chain": "txflow",
  "dst_address": "0x0000000000000000000000000000000000000001",
  "symbol": "USDCARB"
}'

Try it

POST https://devnet-bridge.txflow.net/api/v1/bridge/deposit-address

Response 200

codeinteger

`0` on success.

dataobject

deposit_addressstring

Pay this address (deposit) or [`tokenSend`](/api/exchange/tokenSend) to it (withdraw).

fromstring

Optional source-chain peg.

memostringnullable

Memo / tag when the source chain `support_memo` is true.

messagestring

Response example

{
  "code": 0,
  "data": {
    "deposit_address": "0xabc…",
    "from": "0xdef…",
    "memo": null
  },
  "message": "success"
}

Deposit (external → TxFlow)

Field	Value
`src_chain`	User's source network (`ethereum`, `solana`, …)
`dst_chain`	`"txflow"`
`dst_address`	User's TxFlow address
`deposit_address` (response)	Address to pay on `src_chain` (QR / copy)

Withdraw (TxFlow → external)

Field	Value
`src_chain`	`"txflow"`
`dst_chain`	Target network
`dst_address`	User's address on that network
`deposit_address` (response)	Peg to `tokenSend` on TxFlow

Next steps

After a withdraw peg is issued, submit tokenSend (USDC perp → perp; other assets spot → spot).