FX Settings: MPC Vault Registration & Auto-Signing

Configure your fintech’s FX infrastructure by registering an MPC vault, enabling automatic transaction signing, and tuning per-trade USD thresholds. Every order you place on the orderbook and every trade you execute depends on a correctly registered MPC vault, so complete this setup before interacting with any other FX endpoint.

Endpoints Overview

Section	Endpoint	Method	Description
Register MPC Vault	`/fx/mpc/register`	POST	Register MPC vault configuration for FX trading operations
Get FX Settings	`/fx/settings`	GET	Retrieve complete FX settings including MPC vault and wallets
Enable Auto Signing	`/fx/auto-signing/enable`	POST	Enable automatic transaction signing for FX trades
Disable Auto Signing	`/fx/auto-signing/disable`	POST	Disable automatic transaction signing
Set Auto Signing Threshold	`/fx/auto-signing/threshold`	POST	Set the USD threshold for auto-signing transactions
Get Auto Signing Status	`/fx/auto-signing/status`	GET	Retrieve auto-signing configuration and today’s statistics
Get Auto Signing Stats	`/fx/auto-signing/stats`	GET	Retrieve auto-signing statistics over a rolling period

Register MPC Vault

Register your MPC vault configuration to enable FX trading. This step is required before you can create limit orders or execute trades. Your registration is submitted for admin approval and the cNGN wallet is automatically assigned to your fintech smart wallet.

The mpcVaultApiKey and mpcClientSignerPrivateKey are sensitive credentials. Store them securely and never expose them in client-side code or logs. Both fields are partially masked in all API responses.

MPC Vault is a third-party wallet infrastructure provider independent of Strails. You must create and maintain your own account at mpcvault.com. All interactions with MPC Vault are subject to MPC Vault’s own terms and conditions. Strails assumes no liability for losses arising from the use of MPC Vault services.

Request
Response

curl --request POST \
  --url https://api.strails.io/v1/fx/mpc/register \
  --header "x-api-key: <API_KEY>" \
  --header "Content-Type: application/json" \
  --data '{
    "mpcVaultApiKey": "your-mpc-vault-api-key",
    "callbackClientSignerPublicKey": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAI... mpcvault-client-signer",
    "mpcClientSignerPrivateKey": "-----BEGIN OPENSSH PRIVATE KEY-----\n<base64-line-1>\n<base64-line-2>\n<base64-line-3>\n-----END OPENSSH PRIVATE KEY-----",
    "vaultId": "your-mpc-vault-id",
    "tokenWallets": {
      "USDT": "0x9e9fd8e75E07A1xxxxxxxxx",
      "USDC": "0x9e9fd8e75E07A1xxxxxxxxx"
    },
    "notificationEmails": [
      "admin@yourcompany.com"
    ]
  }'

The mpcClientSignerPrivateKey must encode newlines as \n escape sequences. Each line of your OpenSSH private key must be separated by a literal \n character, not an actual line break.

string

required

Your MPC Vault API key, obtained from the MPC Vault dashboard.

string

required

The SSH public key used to verify callback signatures from MPC Vault.

string

required

Your OpenSSH private key with \n as the newline separator between each base64-encoded line.

string

required

Your MPC Vault identifier, found in the MPC Vault dashboard.

object

required

Wallet addresses for each supported stablecoin.

Show tokenWallets fields

string

required

Wallet address used for USDT operations.

string

required

Wallet address used for USDC operations.

array

required

One or more email addresses that will receive FX event notifications.

{
  "status": "Success",
  "response_code": "00",
  "message": "MPC vault registered successfully. Awaiting admin approval.",
  "data": {
    "vaultId": "74e8defc-5569-4f01-86c9-0XXXXXXX",
    "status": "pending",
    "tokenWallets": {
      "USDT": "0x9e9fd8e75E07A1xxxxxxxxx",
      "USDC": "0x9e9fd8e75E07A1xxxxxxxxx",
      "cNGN": "0x3af904Ff6FA747xxxxxxxxx"
    },
    "createdAt": "2026-05-01T10:30:00.000Z",
    "note": "Your MPC configuration is pending admin approval. You will be notified once approved. cNGN wallet automatically set to your smart wallet."
  }
}

string

Your registered MPC Vault identifier.

string

Registration status. Returns pending until a Strails admin approves the configuration.

object

Registered wallet addresses, including the cNGN wallet automatically assigned to your fintech smart wallet.

string

ISO 8601 UTC timestamp of the registration request.

string

Status information and next steps.

Get FX Settings

Retrieve your fintech’s complete FX configuration after Strails admin approval. The response includes MPC vault credentials (partially masked), auto-signing VM details, token wallet addresses, and notification settings.

Once auto-signing is enabled, you must add the natExternalIp value returned in this response to both your MPC Vault API allowlist and your MPC Vault IP whitelist. Without this step, auto-signing requests will be rejected by MPC Vault. If auto-signing ever fails, Strails automatically falls back to manual approval so that active trades are not lost.

Request
Response

curl --request GET \
  --url https://api.strails.io/v1/fx/settings \
  --header "x-api-key: <API_KEY>"

{
  "status": "Success",
  "response_code": "00",
  "message": "FX settings retrieved successfully",
  "data": {
    "vaultId": "74e8defc-5569-4f01-86c9-0XXXXXXX",
    "mpcVaultApiKey": "4nzx**************...",
    "mpcClientSignerPrivateKey": "tGyH****************...",
    "callbackClientSignerPublicKey": "ssh-ed25519 AAAA... mpcvault-client-signer",
    "mpcConfigStatus": "active",
    "autoSigning": {
      "available": true,
      "enabled": true,
      "threshold": "10000",
      "vmStatus": "running",
      "vmInstanceName": "mpc-signer-c8fe1911-d292-4f84-a-xxxxxx",
      "natExternalIp": "35.192.15.0",
      "note": "Add this IP to MPC Vault allowlist"
    },
    "tokenWallets": {
      "USDT": "0x9e9fd8e75E07A1xxxxxxxxx",
      "USDC": "0x9e9fd8e75E07A1xxxxxxxxx",
      "cNGN": "0x3af904Ff6FA747xxxxxxxxx"
    },
    "notificationEmails": [
      "admin@yourcompany.com"
    ]
  }
}

string

Your MPC Vault identifier.

string

Your MPC Vault API key, partially masked for security.

string

Your MPC client signer private key, partially masked for security.

string

SSH public key used to verify MPC Vault callback signatures.

string

MPC configuration status: active, pending, or inactive.

object

Auto-signing VM configuration and current state.

Show autoSigning fields

boolean

Whether the auto-signing feature has been provisioned for your fintech.

boolean

Whether auto-signing is currently active.

string

The USD value threshold below which trades are automatically signed.

string

Google Cloud VM instance status: running, stopped, or terminated.

string

The Cloud VM instance name hosting the auto-signer process.

string

External IP address of the auto-signer VM. Add this to your MPC Vault allowlist.

string

Configuration reminder, typically the IP allowlist instruction.

object

Wallet addresses for USDT, USDC, and cNGN.

array

Email addresses receiving FX event notifications.

Enable Auto-Signing

Enable automatic transaction signing for FX trades. When enabled, any trade whose USD value falls at or below your configured threshold is signed by the auto-signer VM without manual intervention.

Request
Response

curl --request POST \
  --url https://api.strails.io/v1/fx/auto-signing/enable \
  --header "x-api-key: <API_KEY>" \
  --header "Content-Type: application/json" \
  --data '{}'

{
  "status": "Success",
  "response_code": "00",
  "message": "Auto-signing enabled successfully",
  "data": {
    "autoSigning": {
      "enabled": true,
      "usdThreshold": "10000",
      "vmHealthy": true,
      "vmStatus": "running"
    }
  }
}

boolean

Auto-signing status, now true.

string

The USD threshold currently in effect for auto-signing.

boolean

Whether the auto-signer VM is responding to health checks.

string

Current VM instance status.

Disable Auto-Signing

Disable automatic transaction signing. After disabling, all FX trades will require manual approval through MPC Vault regardless of their USD value.

Request
Response

curl --request POST \
  --url https://api.strails.io/v1/fx/auto-signing/disable \
  --header "x-api-key: <API_KEY>" \
  --header "Content-Type: application/json" \
  --data '{}'

{
  "status": "Success",
  "response_code": "00",
  "message": "Auto-signing disabled successfully",
  "data": {
    "autoSigning": {
      "enabled": false
    }
  }
}

boolean

Auto-signing status, now false.

Set Auto-Signing Threshold

Set the USD value threshold for automatic signing. Trades at or below this threshold are auto-signed when auto-signing is enabled; trades above the threshold require manual MPC Vault approval.

Request
Response

curl --request POST \
  --url https://api.strails.io/v1/fx/auto-signing/threshold \
  --header "x-api-key: <API_KEY>" \
  --header "Content-Type: application/json" \
  --data '{
    "usdThreshold": "10000"
  }'

string

required

The maximum USD equivalent trade value that will be automatically signed. Trades above this value require manual approval. For example, "10000" means trades worth up to $10,000 USD are auto-signed.

{
  "status": "Success",
  "response_code": "00",
  "message": "Auto-signing threshold updated successfully",
  "data": {
    "autoSigning": {
      "enabled": true,
      "usdThreshold": "10000"
    }
  }
}

boolean

Current auto-signing enabled state.

string

The newly applied USD threshold value.

Get Auto-Signing Status

Retrieve the current auto-signing configuration alongside today’s signing statistics, including how many trades were auto-signed, how many fell back to manual approval, and average execution time.

Request
Response

curl --request GET \
  --url https://api.strails.io/v1/fx/auto-signing/status \
  --header "x-api-key: <API_KEY>"

{
  "status": "Success",
  "response_code": "00",
  "message": "Auto-signing configuration retrieved",
  "data": {
    "autoSigning": {
      "configured": true,
      "enabled": true,
      "usdThreshold": "10000",
      "vmStatus": "running",
      "vmHealthy": true,
      "todayStats": {
        "totalAutoSigned": 42,
        "totalUsdAutoSigned": "187500",
        "fallbackCount": 2,
        "successRate": 95.45,
        "avgExecutionTimeMs": 1240
      }
    }
  }
}

boolean

Whether auto-signing has been set up for your fintech.

boolean

Whether auto-signing is currently active.

string

The USD threshold currently configured for auto-signing.

string

Current status of the auto-signer VM instance.

boolean

Whether the VM is passing health checks.

object

Signing statistics for the current calendar day (UTC).

Show todayStats fields

number

Number of trades auto-signed today.

string

Cumulative USD value of all auto-signed trades today.

number

Number of trades that fell back to manual approval today.

number

Auto-signing success rate as a percentage (0-100).

number

Average time in milliseconds from trade creation to auto-sign completion.

Get Auto-Signing Stats

Retrieve daily auto-signing statistics over a rolling window of days, along with aggregate totals across the entire period. Use this endpoint to audit signing activity or troubleshoot threshold configuration.

Request
Response

curl --request GET \
  --url "https://api.strails.io/v1/fx/auto-signing/stats?days=7" \
  --header "x-api-key: <API_KEY>"

number

Number of days to include in the statistics window. Defaults to 7 if omitted.

{
  "status": "Success",
  "response_code": "00",
  "message": "Auto-signing statistics retrieved",
  "data": {
    "stats": {
      "days": 7,
      "daily": [
        {
          "date": "2026-05-01",
          "totalAutoSigned": 38,
          "totalAmountAutoSigned": "142000",
          "fallbackCount": 1,
          "successRate": 97.44,
          "avgExecutionTimeMs": 1180
        }
      ],
      "totals": {
        "totalAutoSigned": 210,
        "totalAmountAutoSigned": "876000",
        "totalFallbacks": 8,
        "avgSuccessRate": 96.30
      }
    }
  }
}

number

The number of days covered by this response.

array

Array of per-day statistics objects, one entry per calendar day (UTC).

Show daily entry fields

string

Calendar date in YYYY-MM-DD format.

number

Number of trades auto-signed on this day.

string

Total USD value of trades auto-signed on this day.

number

Number of trades that fell back to manual approval on this day.

number

Auto-signing success rate for this day as a percentage (0-100).

number

Average execution time in milliseconds for this day.

object

Aggregate figures across all days in the requested window.

Show totals fields

number

Total number of auto-signed trades across all days.

string

Total USD value of all auto-signed trades across all days.

number

Total number of manual-approval fallbacks across all days.

number

Average daily success rate across all days as a percentage.

Overview

Core APIs

FX & Trading

Configuration

FX Settings: MPC Vault Registration & Auto-Signing

Endpoints Overview

Register MPC Vault

Get FX Settings

Enable Auto-Signing

Disable Auto-Signing

Set Auto-Signing Threshold

Get Auto-Signing Status

Get Auto-Signing Stats

​Endpoints Overview

​Register MPC Vault

​Get FX Settings

​Enable Auto-Signing

​Disable Auto-Signing

​Set Auto-Signing Threshold

​Get Auto-Signing Status

​Get Auto-Signing Stats

Endpoints Overview

Register MPC Vault

Get FX Settings

Enable Auto-Signing

Disable Auto-Signing

Set Auto-Signing Threshold

Get Auto-Signing Status

Get Auto-Signing Stats