EVM Only APIs

PreviousAlgorand Only APIs NextError Codes

Last updated 11 months ago

EVM Only APIs

EVM chains include Avalanche, Binance Smart Chain, Base, Ethereum, and Polygon. Some capabilities are chain specific and some are specific to asset standards. If you need more info about asset standards or would like to request we support a specific asset standard's capability, please reach out to us.

Token Details

When giving wallet holders the ability to add an asset, you may choose to fetch information about the asset directly offchain. This EVM only API is capable of pulling the name, symbol, and decimal of an asset given the contract address.

Since multiple on-chain assets may share names/symbols, you must first add the asset to your business directly and then a wallet holder will be able to add the correct one. More detail about this in Assets, Addresses, & Balance Fetching APIs.

Transfer Restrictions

ERC-1404s and the equivalent on other EVMs function as a security token standard that enables the creator to define restrictions. For example, you can restrict transfers to certain addresses or only allow them after certain holding periods. These APIs enable you to check if and why a transfer is restricted BEFORE sending the transaction saving the wallet holder fees and/or time on reverted/failed transactions. See more in Transfer API

Spending Authorization (aka Allowance)

ERC-20s and token standards that build on ERC-20s such as the 1404 enable you to allow a designated address to spend a specified amount of funds on your behalf. This is similar to a spending authorization. This also works on most other EVM blockchains. See Spending Authorization for more detail.

PreviousAlgorand Only APIs NextError Codes

Last updated 11 months ago

Request EVM token asset info like decimals, name and symbol

get

Authorizations

Query parameters

chainNamestring · enumRequiredAvailable options:

tokenContractAddressstringRequired

EVM token contract address on chain

Example: 0x28aef3b18daec312860dd030102a427ed43dac71

Responses

application/json

objectOptional

get

GET /api/v1/query/fetch-token-info?chainName=BITCOIN&tokenContractAddress=text HTTP/1.1
Host: 
X-API-KEY: YOUR_API_KEY
Accept: */*

200

EVM token asset info returned successfully

{
  "decimals": 18,
  "symbol": "USDC",
  "name": "USD Coin",
  "tokenContractAddress": "0x28aef3b18daec312860dd030102a427ed43dac71"
}

Request to detect whether there is a transfer restriction on a particular transaction

get

Authorizations

Query parameters

fromAddressstringRequired

Origin address

Example: 0x9bf4001d307dfd62b26a2f1307ee0c0307632d59

toAddressstringRequired

Recipient address

Example: 0xb44e88ff3c67de6e6548a6caf006bf6e1cb84111

valuestringRequired

value being sent

Example: 109203.1281

assetIdstringRequired

Asset ID inside wallaby system

Example: ed378076-80c0-43ed-9914-5988e1abd748

tokenContractAddressstringOptional

Optional ERC1404 token contract address on chain, when this is supplied, the assetId field will be ignored

Example: 0x28aef3b18daec312860dd030102a427ed43dac71

Responses

application/json

objectOptional

get

GET /api/v1/transactions/detect-transfers-restrictions?fromAddress=text&toAddress=text&value=text&assetId=text HTTP/1.1
Host: 
X-API-KEY: YOUR_API_KEY
Accept: */*

200

Restriction info returned successfully

{
  "canTransfer": true,
  "restrictionCodeMessage": "SUCCESS",
  "tokenContractAddress": "0xb44e88ff3c67de6e6548a6caf006bf6e1cb84111",
  "fromAddress": "0x9bf4001d307dfd62b26a2f1307ee0c0307632d59",
  "toAddress": "0xb44e88ff3c67de6e6548a6caf006bf6e1cb84111",
  "value": "109203.1281",
  "assetId": "ed378076-80c0-43ed-9914-5988e1abd748"
}

Request restriction message by providing a restriction code

get

Authorizations

Query parameters

restrictionCodenumberRequired

Restriction code to be interpreted by the API, by reading data from the contract

Example: 0

assetIdstringRequired

Asset ID inside wallaby system

Example: ed378076-80c0-43ed-9914-5988e1abd748

tokenContractAddressstringOptional

Optional ERC1404 token contract address on chain, when this is supplied, the assetId field will be ignored

Example: 0x28aef3b18daec312860dd030102a427ed43dac71

Responses

application/json

objectOptional

get

GET /api/v1/transactions/transfer-restriction-message?restrictionCode=1&assetId=text HTTP/1.1
Host: 
X-API-KEY: YOUR_API_KEY
Accept: */*

200

Restriction message info returned successfully

{
  "restrictionCode": 0,
  "restrictionCodeMessage": "SUCCESS"
}

Create an allowance for others to spend on your behalf

post

Authorizations

Body

messagestringRequired

Message retrieved from the backend

Example: 717ea458b62a430cb37ced7c22ebec97

clientAuthPubKeystringRequiredExample:

e3421d7f9d6888ea83bef6b28ce0a2ab6eb6fe8a8fbfa3743240992590816b08f9a62edcc63296d056c552054d583fec36d23ef11dffb24c95aaf4a47d50dccc

signaturestringRequired

Signature generated after signing the provided data field

Example:

0xb44e88ff3c67de6e6548a6caf006bf6e1cb841119d0b9ea1b7e9b2d36a5e0ed42fd9f5e543243d1d73dc4b7800cc2026f74961f4edc769699678a316abb34e661c

ownerAddressstringRequired

The owner's address

Example: 0x44Fa139F39D97b000cfAB1266ce8154782Bcef9D

spenderAddressstringRequired

The spender's address

Example: 0x44Fa139F39D97b000cfAB1266ce8154782Bcef9D

amountnumberRequired

The amount the owner wishes to allow the spender to spend

Example: 10

assetIdstringRequired

The asset ID for which you wish to specify an alloance

Example: ed378076-80c0-43ed-9914-5988e1abd748

contractAddressstringRequired

The asset contract address

Example: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48

referencestringRequired

Transaction reference

Example: a4dedb83-4d59-41ca-84b5-4b24a98878d8

memostringRequired

Transaction memo or note

Example: Allowance for buying NOTE

encryptedSeedall ofRequired

Seed encrypted asymmetrically by current user corresponding wallaby auth public key, to be decrypted inside the secure code execution environment

Example:

{"iv":"b7b643ebccf35c262aa2d5c2729c5f3d","ephemPublicKey":"040cff71ed16f1105c45c2214c9e72d3eabde48efe3759c6f150352b19aa8054c302dc1fd8b4f3927bd7d74ae0186854b3a13de7673be4f8424a6ba3702c239729","ciphertext":"736bc1881a02fa08df4a3f1e35d426660e3c35471facba2866e960f8a19b783bac30d037b07dc9e6406e258d09a4a7e4a7cf58d20cf7b8b7201db0f80849a48d20389039e3fc196f42796fe6d501f47afb030f9946ecbc148d8da1e46c3793a4","mac":"b6cbbdbbc3a311d919340fc3ec9ee1911d9ead6d989efa73e0ac3303c51a353e"}

Responses

application/json

objectOptional

post

POST /api/v1/transactions/create-allowance HTTP/1.1
Host: 
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 1182

{
  "message": "717ea458b62a430cb37ced7c22ebec97",
  "clientAuthPubKey": "e3421d7f9d6888ea83bef6b28ce0a2ab6eb6fe8a8fbfa3743240992590816b08f9a62edcc63296d056c552054d583fec36d23ef11dffb24c95aaf4a47d50dccc",
  "signature": "0xb44e88ff3c67de6e6548a6caf006bf6e1cb841119d0b9ea1b7e9b2d36a5e0ed42fd9f5e543243d1d73dc4b7800cc2026f74961f4edc769699678a316abb34e661c",
  "ownerAddress": "0x44Fa139F39D97b000cfAB1266ce8154782Bcef9D",
  "spenderAddress": "0x44Fa139F39D97b000cfAB1266ce8154782Bcef9D",
  "amount": 10,
  "assetId": "ed378076-80c0-43ed-9914-5988e1abd748",
  "contractAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  "reference": "a4dedb83-4d59-41ca-84b5-4b24a98878d8",
  "memo": "Allowance for buying NOTE",
  "encryptedSeed": "{\"iv\":\"b7b643ebccf35c262aa2d5c2729c5f3d\",\"ephemPublicKey\":\"040cff71ed16f1105c45c2214c9e72d3eabde48efe3759c6f150352b19aa8054c302dc1fd8b4f3927bd7d74ae0186854b3a13de7673be4f8424a6ba3702c239729\",\"ciphertext\":\"736bc1881a02fa08df4a3f1e35d426660e3c35471facba2866e960f8a19b783bac30d037b07dc9e6406e258d09a4a7e4a7cf58d20cf7b8b7201db0f80849a48d20389039e3fc196f42796fe6d501f47afb030f9946ecbc148d8da1e46c3793a4\",\"mac\":\"b6cbbdbbc3a311d919340fc3ec9ee1911d9ead6d989efa73e0ac3303c51a353e\"}"
}

200

Allowance has been created successfully

{
  "transaction": {
    "reference": "text",
    "hash": "text",
    "userId": "text",
    "merchantId": "text",
    "userEmail": "text",
    "chainId": "text",
    "chainName": "text",
    "chainSlip44": 1,
    "fromWalletId": "text",
    "fromAddress": "text",
    "toWalletId": "text",
    "toAddress": "text",
    "assetId": "text",
    "assetSymbol": "text",
    "tokenType": "text",
    "amount": "text",
    "fee": "text",
    "note": "text",
    "nonce": 1,
    "gasPrice": 1,
    "submitter": "text",
    "status": "text",
    "ownershipType": "text",
    "multisigVersion": 1,
    "multisigSignerThreshold": 1,
    "multisigSignerApprovedCount": 1,
    "txBlob": "text",
    "multisigParticipants": [
      {
        "transactionId": "text",
        "userAddress": "text",
        "userId": "text",
        "chainId": "text",
        "chainName": "text",
        "assetId": "text",
        "assetName": "text",
        "assetSymbol": "",
        "status": "pending-approval",
        "transaction": "[Circular Reference]",
        "user": {
          "id": "text",
          "externalUserId": "6e464058-67c1-4273-a6a4-8aae522e34be",
          "merchantId": "6e464058-67c1-4273-a6a4-8aae522e34be",
          "role": "republic_admin",
          "firstName": "Bryan",
          "walletsCount": 2,
          "latestWallabyAuthPubKey": "4ecb720b1392468c75803d6252ac987c113206955070b96df1208c1c480338168e1407cec4b5af2f91d12af9b725cbd85af994b29c6364971a7ef8d955be83dc",
          "latestWallabyAuthPubKeyVersion": "1",
          "hasFullPermissions": true
        }
      }
    ],
    "merchant": {
      "name": "Republic",
      "nameSlugify": "republic",
      "verified": true,
      "contactEmail": "[email protected]",
      "contactPhoneNumber": "text",
      "usersCount": 1,
      "assetsCount": 1,
      "tokensCount": 1,
      "coinsCount": 1,
      "walletsCount": 1,
      "status": "active",
      "createdAt": "2025-04-24T06:33:28.587Z",
      "updatedAt": "2025-04-24T06:33:28.587Z",
      "createdAssets": [
        []
      ]
    }
  }
}