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:
Secure token-based authentication system
Support for multiple providers (Cryptix, Finchpay, Wert, Paybis, Moonpay, Mercuryo)
Multiple cryptocurrencies across Ethereum, Polygon, Arbitrum, Base, Solana, BSC, Tron, and more
Payment methods: Credit/debit card
Server-side parameter storage for maximum security
Single-use tokens with automatic expiration
POST Create 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 -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 (200)
Error (400)
{
"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;
}
GET Get 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 'https://widget.stixramp.com/api/crypto_list.php'
Example Response
{
"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
{
"error": "Missing Parameters",
"message": "Missing required parameters: wallet_address",
"required": [
"fiat_currency",
"crypto_currency",
"fiat_amount",
"wallet_address",
"provider"
]
}
{
"error": "Amount Too Low",
"message": "Minimum order amount for Cryptix is 25.00 EUR equivalent.",
"min_amount": 25.00,
"provider": "cryptix"
}