Persistent deposit address

This API is currently work in progress.

post

Returns a chain-specific deposit address that funnels deposits into the recipient's account. The same address is returned for repeat calls with the same recipient + depositChain, so users can safely save it externally.

EVM chains share one address. Across different EVM chains you only need to generate the deposit address once using any EVM chain as depositChain. The returned address works automatically for deposits on every other supported EVM chain — no need to call this endpoint again per EVM chain.

Path parameters

apiKeystringRequired

API key generated at https://studio.aurora.dev

Body

application/json

To specify the asset the user receives, you can either:

• Pass a token symbol in destinationAsset (e.g. "USDC") together with destinationChain (e.g. "base"). The API resolves the symbol to an asset ID on that chain.
• Or pass an asset ID directly in destinationAsset (e.g. "nep141:base-0x...omft.near"). destinationChain is still required to locate it.

When a symbol matches more than one token on the same destinationChain, the request fails with 400 and an error listing the matching asset IDs ("Multiple tokens with symbol ... Use one of the asset IDs instead: ..."). In that case, retry with the specific asset ID you want.

recipientstringRequired

Target address on the destination chain. Funds deposited to the returned address will ultimately route to this address.

Example: 0x2527D02599Ba641c19FEa793cD0F167589a0f10D

senderstringRequired

Identifier of the user the deposit address is generated for (e.g. their ID in the system). A unique deposit address is generated and persisted per (sender, recipient, depositChain), so incoming deposits can be attributed to a specific user.

Example: some-user-id

depositChainstring · enumRequired

Chain the user deposits FROM (the chain of the returned deposit address). Short code matching the widget config Chains enum, e.g. "arb" for Arbitrum.

Example: arbPossible values:

destinationChainstring · enumRequired

Chain the user receives funds ON. Used to resolve destinationAsset when it is provided as a symbol. Short code matching the widget config Chains enum, e.g. "base" for Base.

Example: basePossible values:

destinationAssetstringRequired

Asset the user wants to receive on destinationChain. Accepts either a token symbol (e.g. "USDC") or an asset ID (e.g. "nep141:base-0x...omft.near"). When a symbol is used and more than one token shares that symbol on destinationChain, the request is rejected with 400 and the caller must switch to the asset ID.

Example: USDC

Responses

200

Persistent deposit address generated or fetched from cache

application/json

Persistent deposit address generated or fetched from cache

depositAddressstringRequired

Chain-specific deposit address. Sending any supported asset on this chain to this address will deposit funds into the NEAR Intents account associated with recipient.

Example: 0x76b4c56085ED136a8744D52bE956396624a730E8

400

Default Response

application/json

404

Application key is not assigned or no token matches destinationAsset on destinationChain

application/json

500

Internal Server Error - Failed to call upstream services

application/json

post

/api/persistent-deposit-address/{apiKey}

HTTPcURLJavaScriptPython

POST /api/persistent-deposit-address/{apiKey} HTTP/1.1
Host: intents-api.aurora.dev
Content-Type: application/json
Accept: */*
Content-Length: 155

{
  "recipient": "0x2527D02599Ba641c19FEa793cD0F167589a0f10D",
  "sender": "some-user-id",
  "depositChain": "arb",
  "destinationChain": "base",
  "destinationAsset": "USDC"
}

{
  "depositAddress": "0x76b4c56085ED136a8744D52bE956396624a730E8"
}