Stixramp - Onramp crypto API: High-Performance Crypto Gateway with Instant Processing

Stixramp is a crypto onramp platform that allows users to purchase cryptocurrencies with traditional payment methods. Our API offers simple and secure integration for developers and partners.

Main features:

POSTCreate Secure Token

Endpoint URL
POST https://widget.stixramp.com/api/partner/create_token.php

Creates a secure token for an onramp transaction. This endpoint uses server-to-server authentication with API key in headers. The token contains encrypted transaction parameters stored server-side, ensuring maximum security. The client receives only a widget URL with a token - no sensitive data is exposed.

Security Features

  • Double Token System: Partner token (15 min) → Session token (5 min)
  • Server-side Storage: Wallet address & amount never exposed to client
  • Single-use Tokens: Each token can only be used once
  • HMAC Signatures: Token integrity guaranteed
  • Zero Client Exposure: Parameters stored in database, not in URLs or HTML

Request Headers

Header Type Required Description
X-API-KEY string Required Your partner API key (never exposed to client)
Content-Type string Required Must be application/json

Request Body (JSON)

Parameter Type Required Description
fiat_currency string Required Fiat currency (EUR, USD, GBP, CHF, AUD, CAD)
crypto_currency string Required Cryptocurrency with network (e.g., USDC_POLYGON, BTC, ETH_ETHEREUM). See supported currencies.
fiat_amount number Required Amount in fiat currency (ex: 100)
wallet_address string Required Destination wallet address (stored server-side)
provider string Required Onramp provider (cryptix or finchpay)
email string Required Customer Email
payment_method string Optional Payment method (default: credit_card)
Example Request
cURL Example
curl -X POST 'https://widget.stixramp.com/api/partner/create_token.php' \
  -H 'X-API-KEY: sk_4bc41b17359a420a49e5d3de676f0befac0e5b3295ced9e70c68aeb9a2bf' \
  -H 'Content-Type: application/json' \
  -d '{
    "fiat_currency": "EUR",
    "crypto_currency": "USDC_POLYGON",
    "fiat_amount": 100,
    "wallet_address": "0x981c1D1B887ab19D5d9cdF2508527cBBaFF113Dc",
    "provider": "cryptix",
    "payment_method": "credit_card",
	"email": "user@example.com"
  }'
Example Response
Success Response
200 OK
{ "success": true, "token": "a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456", "widget_url": "https://widget.stixramp.com/api/partner/widget.php?token=a1b2c3d4e5f6...", "expires_at": "2025-10-16 15:30:00", "expires_in_seconds": 900 }

Next Step: Redirect Your Client

  • Redirect the user to widget_url from your backend
  • The user will see the Stixramp widget with pre-filled parameters
  • Token is valid for 15 minutes and single-use only
  • Wallet address and amount are never exposed to the client

Integration Example (PHP)

// Step 1: Create token from your backend
$response = makeApiRequest('POST', 'https://widget.stixramp.com/api/partner/create_token.php', [
    'X-API-KEY' => 'sk_your_api_key',
    'Content-Type' => 'application/json'
], [
    'fiat_currency' => 'EUR',
    'crypto_currency' => 'USDC_POLYGON',  // Specify network!
    'fiat_amount' => 100,
    'wallet_address' => $userWallet,
    'provider' => 'cryptix'
]);

// Step 2: Redirect user to widget_url
if ($response['success']) {
    header('Location: ' . $response['widget_url']);
    exit;
}

GETGet Crypto List

Endpoint URL
GET https://widget.stixramp.com/api/crypto_list.php

Returns the complete list of supported cryptocurrencies with their networks. This endpoint is public and does not require authentication.

Example Request
cURL Example
curl 'https://widget.stixramp.com/api/crypto_list.php'
Example Response
Success Response
200 OK
{ "success": true, "version": "2.0", "cryptocurrencies": [ { "code": "USDC_POLYGON", "name": "USDC", "symbol": "USDC", "network": "Polygon", "network_code": "polygon", "icon": "https://cdn.changelly.com/icons-colored/usdc.png" }, { "code": "BTC", "name": "Bitcoin", "symbol": "BTC", "network": "Bitcoin", "network_code": "bitcoin", "icon": "https://cdn.changelly.com/icons-colored/btc.png" }, ... ], "fiat_currencies": ["EUR", "USD", "GBP", "CHF", "AUD", "CAD"], "total_cryptocurrencies": 38, "total_fiat_currencies": 9 }

Usage in Your Application

  • Use the code field as the value for crypto_currency parameter
  • Display the symbol and network to your users
  • For multi-chain tokens (USDC, USDT), always include the network in the code
  • The endpoint is cached for 1 hour for optimal performance

Supported Providers

Stixramp supports multiple onramp providers to offer the best user experience:

Name Slug Available Payment Methods Min Amount (EUR)
Cryptix cryptix Credit/Debit Card 15.00 EUR
Finchpay finchpay Credit/Debit Card 30.00 EUR
Wert wert Credit/Debit Card 1.00 EUR
Mercuryo mercuryo Credit/Debit Card 10.00 EUR
Paybis paybis Credit/Debit Card 5.00 EUR

Minimum Order Amounts

Each provider has a minimum order amount requirement. If you attempt to create a token with an amount below the minimum, you will receive a 400 error with the message "Amount Too Low". Make sure to validate the amount on your side before creating the token.

Supported Currencies

Native Chain Cryptocurrencies

Code Name Network
BTC Bitcoin Bitcoin
ETH_ETHEREUM Ethereum Ethereum
SOL Solana Solana
TRX Tron Tron
ADA Cardano Cardano
XRP Ripple Ripple
POLYGON Polygon (MATIC) Polygon

USDC (USD Coin) - Multi-Chain

Code Network Address Format
USDC_POLYGON Polygon 0x... (EVM)
USDC_ETHEREUM Ethereum 0x... (EVM)
USDC_ARBITRUM Arbitrum 0x... (EVM)
USDC_AVALANCHE Avalanche 0x... (EVM)
USDC_BASE Base 0x... (EVM)
USDC_SOLANA Solana Base58
USDC_STELLAR Stellar G... (Stellar format)
USDC_NOBLE Noble noble1...

USDT (Tether) - Multi-Chain

Code Network Address Format
USDT_TRON Tron (TRC-20) T... (Base58)
USDT_ETHEREUM Ethereum 0x... (EVM)
USDT_POLYGON Polygon 0x... (EVM)
USDT_AVALANCHE Avalanche 0x... (EVM)
USDT_SOLANA Solana Base58
USDT_TON TON UQ... / EQ...
USDT_BSC Binance Smart Chain 0x... (BEP-20)

ETH (Ethereum) - Multi-Chain

Code Network Address Format
ETH_ETHEREUM Ethereum 0x... (EVM)
ETH_ARBITRUM Arbitrum 0x... (EVM)
ETH_BASE Base 0x... (EVM)

Other Major Cryptocurrencies

Code Name Network
DAI_ETHEREUM DAI Ethereum
LINK_ETHEREUM Chainlink Ethereum
UNI_ETHEREUM Uniswap Ethereum
SAND_ETHEREUM Sandbox Ethereum
APE_ETHEREUM Apecoin Ethereum
ATOM_COSMOS Cosmos Cosmos
AVAX_AVALANCHE Avalanche Avalanche
BNB_BSC BNB (Binance Coin) Binance Smart Chain
DOT_POLKADOT Polkadot Polkadot
LTC_LITECOIN Litecoin Litecoin
BCH_BITCOINCASH Bitcoin Cash Bitcoin Cash
DOGE_DOGECOIN Dogecoin Dogecoin
POL_POLYGON Polygon (POL) Polygon
ALGO_ALGORAND Algorand Algorand
XTZ_TEZOS Tezos Tezos
APT_APTOS Aptos Aptos
SUI_SUI Sui Sui
SHIB_ETHEREUM Shiba Inu Ethereum
PEPE_ETHEREUM Pepe Ethereum
AAVE_ETHEREUM Aave Ethereum
MKR_ETHEREUM Maker Ethereum
COMP_ETHEREUM Compound Ethereum
BAT_ETHEREUM Basic Attention Token Ethereum
ZRX_ETHEREUM 0x Protocol Ethereum

Fiat Currencies

Code Name
EUR Euro
USD US Dollar
GBP British Pound
CHF Swiss Franc
AUD Australian Dollar
CAD Canadian Dollar

Error Handling

Status Code Error Type Description Solution
200 Success Token created successfully Redirect user to widget_url
400 Bad Request Missing or invalid parameters Check all required parameters in JSON body
400 Amount Too Low Order amount is below provider minimum Check provider minimum amounts (Cryptix: 25 EUR, Finchpay: 20 EUR)
401 Unauthorized Invalid or missing API key Check X-API-KEY header
403 Forbidden Unauthorized domain Add your domain to authorized domains in admin panel
410 Gone Token expired or already used Create a new token (tokens are single-use)
500 Server Error Internal server error Contact support or try again later
Error Response Examples
Missing Parameters
400 Bad Request
{ "error": "Missing Parameters", "message": "Missing required parameters: wallet_address", "required": [ "fiat_currency", "crypto_currency", "fiat_amount", "wallet_address", "provider" ] }
Amount Too Low
400 Bad Request
{ "error": "Amount Too Low", "message": "Minimum order amount for Cryptix is 25.00 EUR equivalent.", "min_amount": 25.00, "provider": "cryptix" }