Check a deposit transaction for the client account

Check my deposit transaction

curl --request POST \
  --url https://prod-api.stableyard.fi/v2/client/me/deposit-addresses/check \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "transactionHash": "0xabc1230000000000000000000000000000000000000000000000000000000000",
  "chainId": 42161,
  "depositAddress": "0x1111111111111111111111111111111111111111",
  "tokenAddress": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
  "logIndex": 0
}
'

import requests

url = "https://prod-api.stableyard.fi/v2/client/me/deposit-addresses/check"

payload = {
    "transactionHash": "0xabc1230000000000000000000000000000000000000000000000000000000000",
    "chainId": 42161,
    "depositAddress": "0x1111111111111111111111111111111111111111",
    "tokenAddress": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "logIndex": 0
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    transactionHash: '0xabc1230000000000000000000000000000000000000000000000000000000000',
    chainId: 42161,
    depositAddress: '0x1111111111111111111111111111111111111111',
    tokenAddress: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
    logIndex: 0
  })
};

fetch('https://prod-api.stableyard.fi/v2/client/me/deposit-addresses/check', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://prod-api.stableyard.fi/v2/client/me/deposit-addresses/check",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'transactionHash' => '0xabc1230000000000000000000000000000000000000000000000000000000000',
    'chainId' => 42161,
    'depositAddress' => '0x1111111111111111111111111111111111111111',
    'tokenAddress' => '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
    'logIndex' => 0
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://prod-api.stableyard.fi/v2/client/me/deposit-addresses/check"

	payload := strings.NewReader("{\n  \"transactionHash\": \"0xabc1230000000000000000000000000000000000000000000000000000000000\",\n  \"chainId\": 42161,\n  \"depositAddress\": \"0x1111111111111111111111111111111111111111\",\n  \"tokenAddress\": \"0xaf88d065e77c8cC2239327C5EDb3A432268e5831\",\n  \"logIndex\": 0\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://prod-api.stableyard.fi/v2/client/me/deposit-addresses/check")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"transactionHash\": \"0xabc1230000000000000000000000000000000000000000000000000000000000\",\n  \"chainId\": 42161,\n  \"depositAddress\": \"0x1111111111111111111111111111111111111111\",\n  \"tokenAddress\": \"0xaf88d065e77c8cC2239327C5EDb3A432268e5831\",\n  \"logIndex\": 0\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://prod-api.stableyard.fi/v2/client/me/deposit-addresses/check")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"transactionHash\": \"0xabc1230000000000000000000000000000000000000000000000000000000000\",\n  \"chainId\": 42161,\n  \"depositAddress\": \"0x1111111111111111111111111111111111111111\",\n  \"tokenAddress\": \"0xaf88d065e77c8cC2239327C5EDb3A432268e5831\",\n  \"logIndex\": 0\n}"

response = http.request(request)
puts response.read_body

{
  "checked": true,
  "detected": true,
  "isTransferDone": true,
  "verified": true,
  "supported": true,
  "chainId": 42161,
  "depositAddress": "0x1111111111111111111111111111111111111111",
  "transactionHash": "0xabc1230000000000000000000000000000000000000000000000000000000000",
  "hashExists": false,
  "depositAddressExists": true,
  "addressMatched": true,
  "reason": "unsupported_deposit_transaction",
  "minimumTransactionAmountAtomic": "10000",
  "minimumTransactionAmount": "0.0001",
  "error": {
    "code": "not_found",
    "message": "transaction not found"
  },
  "idempotent": false,
  "ignored": false
}

{
  "error": {
    "code": "bad_request",
    "message": "The request is invalid",
    "details": "example"
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "The request is invalid",
    "details": "example"
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "The request is invalid",
    "details": "example"
  }
}

POST

client

deposit-addresses

check

Check my deposit transaction

curl --request POST \
  --url https://prod-api.stableyard.fi/v2/client/me/deposit-addresses/check \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "transactionHash": "0xabc1230000000000000000000000000000000000000000000000000000000000",
  "chainId": 42161,
  "depositAddress": "0x1111111111111111111111111111111111111111",
  "tokenAddress": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
  "logIndex": 0
}
'

import requests

url = "https://prod-api.stableyard.fi/v2/client/me/deposit-addresses/check"

payload = {
    "transactionHash": "0xabc1230000000000000000000000000000000000000000000000000000000000",
    "chainId": 42161,
    "depositAddress": "0x1111111111111111111111111111111111111111",
    "tokenAddress": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "logIndex": 0
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    transactionHash: '0xabc1230000000000000000000000000000000000000000000000000000000000',
    chainId: 42161,
    depositAddress: '0x1111111111111111111111111111111111111111',
    tokenAddress: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
    logIndex: 0
  })
};

fetch('https://prod-api.stableyard.fi/v2/client/me/deposit-addresses/check', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://prod-api.stableyard.fi/v2/client/me/deposit-addresses/check",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'transactionHash' => '0xabc1230000000000000000000000000000000000000000000000000000000000',
    'chainId' => 42161,
    'depositAddress' => '0x1111111111111111111111111111111111111111',
    'tokenAddress' => '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
    'logIndex' => 0
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://prod-api.stableyard.fi/v2/client/me/deposit-addresses/check"

	payload := strings.NewReader("{\n  \"transactionHash\": \"0xabc1230000000000000000000000000000000000000000000000000000000000\",\n  \"chainId\": 42161,\n  \"depositAddress\": \"0x1111111111111111111111111111111111111111\",\n  \"tokenAddress\": \"0xaf88d065e77c8cC2239327C5EDb3A432268e5831\",\n  \"logIndex\": 0\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://prod-api.stableyard.fi/v2/client/me/deposit-addresses/check")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"transactionHash\": \"0xabc1230000000000000000000000000000000000000000000000000000000000\",\n  \"chainId\": 42161,\n  \"depositAddress\": \"0x1111111111111111111111111111111111111111\",\n  \"tokenAddress\": \"0xaf88d065e77c8cC2239327C5EDb3A432268e5831\",\n  \"logIndex\": 0\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://prod-api.stableyard.fi/v2/client/me/deposit-addresses/check")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"transactionHash\": \"0xabc1230000000000000000000000000000000000000000000000000000000000\",\n  \"chainId\": 42161,\n  \"depositAddress\": \"0x1111111111111111111111111111111111111111\",\n  \"tokenAddress\": \"0xaf88d065e77c8cC2239327C5EDb3A432268e5831\",\n  \"logIndex\": 0\n}"

response = http.request(request)
puts response.read_body

{
  "checked": true,
  "detected": true,
  "isTransferDone": true,
  "verified": true,
  "supported": true,
  "chainId": 42161,
  "depositAddress": "0x1111111111111111111111111111111111111111",
  "transactionHash": "0xabc1230000000000000000000000000000000000000000000000000000000000",
  "hashExists": false,
  "depositAddressExists": true,
  "addressMatched": true,
  "reason": "unsupported_deposit_transaction",
  "minimumTransactionAmountAtomic": "10000",
  "minimumTransactionAmount": "0.0001",
  "error": {
    "code": "not_found",
    "message": "transaction not found"
  },
  "idempotent": false,
  "ignored": false
}

{
  "error": {
    "code": "bad_request",
    "message": "The request is invalid",
    "details": "example"
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "The request is invalid",
    "details": "example"
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "The request is invalid",
    "details": "example"
  }
}

Submits a transaction hash or signature for independent chain verification against a receive address owned by the client token’s account. Pass tokenAddress or logIndex to disambiguate multiple matching transfers. Known check failures return HTTP 200 with isTransferDone: false and an error object, so read the body, not just the status code.

Authorizations

Authorization

string

header

required

Short-lived account-bound token returned by POST /v2/client/auth/exchange.

Body

application/json

transactionHash

string

required

Observed transaction hash or signature.

Maximum string length: 256

Example:

"0xabc1230000000000000000000000000000000000000000000000000000000000"

chainId

enum<integer>

required

Supported deposit chain IDs: Arbitrum=42161, Ethereum=1, Base=8453, Polygon=137, BNB Smart Chain=56, Avalanche=43114, Robinhood Chain=4663, Tempo=4217, Solana=10103, Movement=10002, Tron=728126428, Bitcoin=10001.

Available options:

42161,

1,

8453,

137,

56,

43114,

4663,

4217,

10103,

10002,

728126428,

10001

Example:

42161

depositAddress

string

required

The account receive address that should have received the transfer.

Required string length: 8 - 256

Example:

"0x1111111111111111111111111111111111111111"

tokenAddress

string

Optional token identifier used to disambiguate multiple matching transfers. Use the configured contract/mint, the EVM zero address for ETH/POL/BNB, native:btc for BTC, or the Solana System Program address for SOL.

Maximum string length: 128

Example:

"0xaf88d065e77c8cC2239327C5EDb3A432268e5831"

logIndex

integer

Optional token log/account index used to disambiguate token transfers. Omit it for native EVM and SOL transfers.

Required range: x >= 0

Response

Deposit check result

checked

boolean

required

Example:

true

detected

boolean

required

Example:

true

isTransferDone

boolean

True only when the hash is verified as a supported deposit transfer to the submitted active deposit address and passes the chain minimum. Known check failures return false with HTTP 200.

Example:

true

verified

boolean

True when a transaction hash was verified through a configured chain RPC.

Example:

true

supported

boolean

False when the transaction exists but is not a supported configured token/native deposit transfer, is unconfirmed, or does not pass the chain minimum.

Example:

true

chainId

enum<integer>

Available options:

42161,

1,

8453,

137,

56,

43114,

4663,

4217,

10103,

10002,

728126428,

10001

Example:

42161

depositAddress

string

Example:

"0x1111111111111111111111111111111111111111"

transactionHash

string

Example:

"0xabc1230000000000000000000000000000000000000000000000000000000000"

hashExists

boolean

False when the hash is malformed or the chain RPC reports the transaction was not found.

Example:

false

depositAddressExists

boolean

False when the submitted deposit address is not active for the account and chain.

Example:

true

addressMatched

boolean

For non-deposit transaction-hash checks, indicates whether the chain transaction appeared to touch the submitted deposit address.

Example:

true

reason

string

Example:

"unsupported_deposit_transaction"

minimumTransactionAmountAtomic

string

Minimum threshold in the asset's atomic units when a verified deposit is ignored for being too small.

Example:

"10000"

minimumTransactionAmount

string

Human-readable minimum threshold when a verified deposit is ignored for being too small.

Example:

"0.0001"

error

object

Known validation, not-found, conflict, or provider-check error returned with HTTP 200 for transaction-hash checks. Provider/RPC details are not exposed.

Show child attributes

idempotent

boolean

Example:

false

ignored

boolean

True when Stableyard recorded the observed deposit but did not create a transaction. Reusable USDC/USDT/USDG deposits are accepted at 0.5 tokens and above except Tron USDT, whose inclusive minimum is 10 USDT. Native BTC has an inclusive minimum of 0.0001 BTC (10,000 sats). Movement THBT is accepted at 16.5 or above. Polygon JPYC is accepted at or above the configured POLYGON_JPYC_MIN_AMOUNT (100 by default). Other native assets retain their documented strict minimum rules.

Example:

false

deposit

object | null

Show child attributes

transaction

object | null

Show child attributes

Introduction

Onboarding

Accounts

Money movement

Activity

Vaults

Client & checkout

Platform

Check a deposit transaction for the client account

Authorizations

Body

Response