API Reference
POSTRequires X-API-Key

Create a UDA address

POST /uda

Allocate a new Universal Deposit Address for your tenant. If a UDA for the `(tenant, owner)` pair already exists, the existing record is returned with `200` instead of an error. `accepted_assets` is a list of asset symbols (e.g. `["USDC", "USDT"]`); if empty, the UDA accepts every asset configured on every UDA-supported chain.

Request body

UDA address configuration.

  • ownerstringrequired

    The owner the UDA is allocated for.

  • Where settlements for this UDA should be delivered.

    • addressstringrequired

      Destination wallet address.

    • network_idstringrequired

      Destination SLIP-44 network id.

    • asset_symbolstring

      Destination asset symbol.

  • accepted_assetsarray<string>

    Asset symbols this UDA accepts; empty means every asset on every UDA-supported chain.

  • Optional; max 3. Specificity-wins precedence: a rule pinning both `source_network_id` and `source_asset_symbol` beats a network-only rule. When nothing matches, settlements use the default destination.

    • Conditions a deposit must meet for this routing rule to apply.

Responses

An existing UDA address for the `(tenant, owner)` pair was returned.

  • idstring
  • ownerstring
  • statusstringenum: active · retired
  • created_atstringformat: date-time

  • Resolved destination (symbol plus the resolved contract address).

    • addressstring
    • network_idstring
    • eip155_idstring
    • network_namestring
    • asset_symbolstring
    • asset_addressstring
    • asset_decimalsinteger
    • addressstring
    • network_idstring
    • eip155_idstring
    • network_namestring

  • Empty when no rules are configured.

Request
curl "https://api.stridge.dev/v1/uda" \
  -X POST \
  -H "X-API-Key: $STRIDGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "owner": "0x9f8e7d6c5b4a39281706f5e4d3c2b1a098765432",
  "destination": {
    "address": "0x3a1f8b2c9d4e5f60718293a4b5c6d7e8f9012345",
    "network_id": "60",
    "asset_symbol": "USDC"
  },
  "accepted_assets": [
    "USDC",
    "USDT"
  ]
}'

Set your key as STRIDGE_API_KEY (sent as X-API-Key).

Response200
"id": "uda_2f8c1a9d4e5f6071",
"owner": "0x9f8e7d6c5b4a39281706f5e4d3c2b1a098765432",
"status": "active",
"created_at": "2026-05-20T14:03:12Z",
"address": "0x3a1f8b2c9d4e5f60718293a4b5c6d7e8f9012345",
"network_id": "60",
"eip155_id": "1",
"network_name": "Ethereum",
"asset_symbol": "USDC",
"asset_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"asset_decimals": 6
},
"address": "0x7c2d9a1b3e4f5061728394a5b6c7d8e9f0a1b2c3",
"network_id": "60",
"eip155_id": "1",
"network_name": "Ethereum",
"symbol": "USDC",
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"decimals": 6,
"logo": "https://assets.stridge.com/tokens/usdc.png"
}
]
}
],
"source_network_id": "60",
"source_asset_symbol": "USDT",
"source_token_address": "0xdAC17F958D2ee523a2206206994597C13D831ec7"
},
"address": "0x3a1f8b2c9d4e5f60718293a4b5c6d7e8f9012345",
"network_id": "60",
"eip155_id": "1",
"network_name": "Ethereum",
"asset_symbol": "USDC",
"asset_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"asset_decimals": 6
}
}
]
}