Check a deposit transaction

Verify and record deposit transaction

curl --request POST \
  --url https://prod-api.stableyard.fi/v2/accounts/{accountId}/deposit-addresses/check \
  --header 'Authorization: Basic <encoded-value>' \
  --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/accounts/{accountId}/deposit-addresses/check"

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

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

print(response.text)

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

fetch('https://prod-api.stableyard.fi/v2/accounts/{accountId}/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/accounts/{accountId}/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: Basic <encoded-value>",
    "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/accounts/{accountId}/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", "Basic <encoded-value>")
	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/accounts/{accountId}/deposit-addresses/check")
  .header("Authorization", "Basic <encoded-value>")
  .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/accounts/{accountId}/deposit-addresses/check")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
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"
  }
}

{
  "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"
  }
}

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

POST

accounts

{accountId}

deposit-addresses

check

Verify and record deposit transaction

curl --request POST \
  --url https://prod-api.stableyard.fi/v2/accounts/{accountId}/deposit-addresses/check \
  --header 'Authorization: Basic <encoded-value>' \
  --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/accounts/{accountId}/deposit-addresses/check"

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

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

print(response.text)

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

fetch('https://prod-api.stableyard.fi/v2/accounts/{accountId}/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/accounts/{accountId}/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: Basic <encoded-value>",
    "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/accounts/{accountId}/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", "Basic <encoded-value>")
	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/accounts/{accountId}/deposit-addresses/check")
  .header("Authorization", "Basic <encoded-value>")
  .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/accounts/{accountId}/deposit-addresses/check")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
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"
  }
}

{
  "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"
  }
}

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

Checks a transaction hash or signature and records it when it is a supported deposit to the account’s receive address. The check verifies the evidence independently and does not replace normal provider-webhook detection. Manual checks cover Arbitrum, Ethereum, Base, Polygon and BNB Chain EVM transactions, Solana signatures, Movement transaction hashes and Bitcoin transaction IDs. Tron deposits are detected by webhook and cannot use this endpoint. 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

HTTP Basic auth. Username is the Stableyard app ID. Password is the app secret. The optional Stableyard-Version request header must match the environment pin.

Headers

Stableyard-Version

enum<string>

Optional contract-version assertion. Omit it to use the app environment's pinned version. A different supported version is accepted only after that environment is explicitly migrated.

Available options:

2026-09-09

Path Parameters

accountId

string

required

Canonical account id returned by the Accounts API.

Example:

"acct_123"

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

Authorizations

Headers

Path Parameters

Body

Response