Submit a deposit

post

Optionally notify the 1Click service that a deposit has been sent to the deposit address, using the blockchain transaction hash. This can speed up swap processing by allowing the system to preemptively verify the deposit. This endpoint is a transparent proxy to the 1Click API.

Path parameters

apiKeystringRequired

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

Body

application/json

txHashstringRequired

Transaction hash of your deposit.

Example: 0xabc123

depositAddressstringRequired

Deposit address returned in the quote response.

Example: 0x76b4c56085ED136a8744D52bE956396624a730E8

nearSenderAccountstringOptional

Sender account (used only for the NEAR blockchain).

Example: sender.near

memostringOptional

Memo. Use if the deposit was submitted with one.

Example: 1111111

Responses

200

Deposit transaction submitted successfully

application/json

Deposit transaction submitted successfully

correlationIdstringRequired

Unique identifier for request tracing and debugging.

Example: 550e8400-e29b-41d4-a716-446655440000

statusstring · enumRequired

Current execution status of the swap:

• KNOWN_DEPOSIT_TX - a deposit transaction is known but not yet confirmed.

• PENDING_DEPOSIT - waiting for the deposit to arrive at the deposit address.

• INCOMPLETE_DEPOSIT - the deposit received is below the required amount.

• PROCESSING - the deposit was received and the swap is being processed.

• SUCCESS - the swap completed successfully.

• REFUNDED - the deposit was refunded.

• FAILED - the swap failed.

Example: SUCCESSPossible values:

updatedAtstringRequired

Timestamp in ISO format when the state was last updated.

Example: 2019-08-24T14:15:22Z

400

Default Response

application/json

500

Internal Server Error - Failed to reach the deposit service

application/json

post

/api/deposit/submit/{apiKey}

HTTPcURLJavaScriptPython

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

{
  "txHash": "0xabc123",
  "depositAddress": "0x76b4c56085ED136a8744D52bE956396624a730E8",
  "nearSenderAccount": "sender.near",
  "memo": "1111111"
}

{
  "correlationId": "550e8400-e29b-41d4-a716-446655440000",
  "quoteResponse": {
    "timestamp": "2019-08-24T14:15:22Z",
    "signature": "<string>",
    "correlationId": "550e8400-e29b-41d4-a716-446655440000",
    "quoteRequest": {
      "dry": true,
      "swapType": "EXACT_INPUT",
      "depositType": "ORIGIN_CHAIN",
      "depositMode": "SIMPLE",
      "quoteWaitingTimeMs": 3000,
      "sessionId": "session_abc123",
      "amount": "1000",
      "originAsset": "nep141:arb-0xaf88d065e77c8cc2239327c5edb3a432268e5831.omft.near",
      "destinationAsset": "nep141:sol-5ce3bf3a31af18be40ba30f721101b4341690186.omft.near",
      "slippageTolerance": 100,
      "refundTo": "0x2527D02599Ba641c19FEa793cD0F167589a0f10D",
      "refundType": "ORIGIN_CHAIN",
      "recipient": "13QkxhNMrTPxoCkRdYdJ65tFuwXPhL5gLS2Z5Nr6gjRK",
      "recipientType": "DESTINATION_CHAIN",
      "virtualChainRecipient": "0xb4c2fbec9d610F9A3a9b843c47b1A8095ceC887C",
      "virtualChainRefundRecipient": "0xb4c2fbec9d610F9A3a9b843c47b1A8095ceC887C",
      "deadline": "2019-08-24T14:15:22Z",
      "connectedWallets": [
        "0x123...",
        "0x456..."
      ],
      "referral": "referral",
      "appFees": [
        {
          "recipient": "recipient.near",
          "fee": 100
        }
      ],
      "customRecipientMsg": "smart-contract-recipient.near"
    },
    "quote": {
      "timeEstimate": 120,
      "deadline": "2025-03-04T15:00:00Z",
      "timeWhenInactive": "2025-03-04T15:00:00Z",
      "depositAddress": "0x76b4c56085ED136a8744D52bE956396624a730E8",
      "depositMemo": "1111111",
      "amountIn": "1000000",
      "amountInFormatted": "1",
      "amountInUsd": "1",
      "minAmountIn": "995000",
      "maxAmountIn": "1005000",
      "amountOut": "9950000",
      "amountOutFormatted": "9.95",
      "amountOutUsd": "9.95",
      "minAmountOut": "9900000",
      "virtualChainRecipient": "0xb4c2fbec9d610F9A3a9b843c47b1A8095ceC887C",
      "virtualChainRefundRecipient": "0xb4c2fbec9d610F9A3a9b843c47b1A8095ceC887C",
      "customRecipientMsg": "smart-contract-recipient.near"
    }
  },
  "status": "SUCCESS",
  "updatedAt": "2019-08-24T14:15:22Z",
  "swapDetails": {
    "intentHashes": [
      "text"
    ],
    "nearTxHashes": [
      "text"
    ],
    "amountIn": "text",
    "amountInFormatted": "text",
    "amountInUsd": "text",
    "amountOut": "text",
    "amountOutFormatted": "text",
    "amountOutUsd": "text",
    "slippage": 1,
    "originChainTxHashes": [
      {
        "hash": "0xabc123",
        "explorerUrl": "https://etherscan.io/tx/0xabc123"
      }
    ],
    "destinationChainTxHashes": [
      {
        "hash": "0xabc123",
        "explorerUrl": "https://etherscan.io/tx/0xabc123"
      }
    ],
    "refundedAmount": "text",
    "refundedAmountFormatted": "text",
    "refundedAmountUsd": "text",
    "refundReason": "text",
    "depositedAmount": "text",
    "depositedAmountFormatted": "text",
    "depositedAmountUsd": "text",
    "referral": "text"
  }
}