Pricing and Orders
Use explicit order orchestration when you need deterministic conversion control. Prices are locked for a short window; orders must be created within that window.
Recommended flow:
- Read spot or reference prices.
- Lock a price for a specific pair.
- Create an order against the lock.
- Read the result: the order comes back
COMPLETEDin the same response.
Get prices
curl -X GET https://sandbox.manteca.dev/crypto/v2/prices/direct/BTC_ARS \
-H "md-api-key: $MD_API_KEY"{
"ticker": "BTC_ARS",
"buy": "95000000.00",
"sell": "93500000.00",
"timestamp": "2024-01-15T14:23:01.000Z"
}buy is the price a user pays to acquire BTC. sell is the price a user receives when selling BTC. All prices include Manteca's spread.
Price lock TTLs
Price locks expire after a fixed window. Create the order before the TTL elapses or the lock will be rejected.
| Lock type | TTL |
|---|---|
| Standard | 20 seconds |
| Custom | Expiration time can be evaluated and configured on request. Please check with your account manager. |
Create an order
Send the lock code as priceCode, with exactly one of assetAmount or againstAmount.
curl -X POST https://sandbox.manteca.dev/crypto/v2/orders \
-H "md-api-key: $MD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"userAnyId": "12345",
"side": "BUY",
"asset": "BTC",
"against": "ARS",
"assetAmount": "0.00100000",
"priceCode": "71c1a89a-7190-4287-82f6-79f0d4e17c0f",
"externalId": "my-order-001"
}'{
"id": "64f1f0a5b6c7d8e9f0012345",
"numberId": "15342",
"externalId": "my-order-001",
"userNumberId": "12345",
"exchange": "ARGENTINA",
"status": "COMPLETED",
"type": "DIRECT",
"side": "BUY",
"asset": "BTC",
"against": "ARS",
"assetAmount": "0.00100000",
"filledAmount": "0.00100000",
"price": "122500000.00",
"effectivePrice": "123112500.00",
"finalClaimInfo": {
"asset": "ARS",
"total": "123112.50",
"base": "122500.00",
"totalFees": "612.50",
"platformFee": "367.50",
"companyProfit": "245.00"
},
"finalCreditInfo": {
"asset": "BTC",
"total": "0.00100000"
},
"creationTime": "2026-07-02T15:30:00.000-03:00"
}The order executes during the request: a successful response is already COMPLETED. finalClaimInfo is what left the user's balance and finalCreditInfo is what entered it.
Minimum order size: The minimum for all orders is the equivalent of 0.1 USD, regardless of the asset pair.
Order statuses
| Status | Description |
|---|---|
COMPLETED | Conversion done; resulting amount credited to user balance. This is the normal response to a successful order. |
CANCELLED | The order was reverted after completing; claimed funds refunded to user balance |
Each status change is also sent as an ORDER_STATUS_UPDATE webhook. See Execution tracking.
Fees
The price returned by the API already includes Manteca's spread, and effectivePrice applies your company's configured fee rate on top of it.
Your company can add a base fee on top of the spread:
baseFee: percentage added to the price (from 0 to 1, where0.05= 5%)
The base fee is kept in full by your company.
Example: 5% baseFee on a 10,000 ARS order:
- Total fee collected: 500 ARS, kept by your company
Fee configuration is set at the company level. Contact your integration manager to configure.
Withdraw network costs
Ramp responses include two fields describing the network cost of the on-chain withdrawal:
withdrawCostInAsset: the withdrawal network cost, expressed in the crypto asset of the pair.withdrawCostInAgainst: the same cost, expressed in the against (fiat) currency of the pair.
Both fields represent the same cost, expressed in the two currencies of the pair, and it is deducted from the amount to withdraw. For a fiat withdrawal the cost is "0".
Order creation error codes
internalStatus | HTTP | Description |
|---|---|---|
INVALID_PARAMS | 400 | Missing or invalid request parameters |
NO_FUNDS | 400 | User has insufficient balance |
EXPIRED_PRICE | 400 | Price lock has expired |
MIN_SIZE | 400 | Order is below the 0.1 USD minimum |
INVALID_COIN | 400 | Asset is not supported |
INVALID_COIN_COUNTRY | 400 | Asset not available in the user's country |
BLOCKED_UIF | 400 | User has exhausted their operation limits |
IS_PEP | 400 | User requires PEP documentation before operating |
USER_NF | 404 | User not found |
PRICE_NF | 404 | Price not found for the requested pair |
USER_BLOCKED | 409 | User account is blocked |
USER_NOT_VALIDATED | 409 | User has not completed onboarding |
ORDER_EXISTS | 409 | An order with this externalId already exists |
OPERATION_BLOCKED | 409 | Operation is blocked by policy or limits |
For idempotency using externalId, see Errors and controls.
Endpoint references
| Action | Endpoint |
|---|---|
| Get all prices | GET /crypto/v2/prices/direct |
| Get pair price | GET /crypto/v2/prices/direct/{ticker} |
| Lock price | POST /crypto/v2/price-locks |
| Get price lock | GET /crypto/v2/price-locks/{code} |
| Create order | POST /crypto/v2/orders |
| Get orders | GET /crypto/v2/orders |
| Get order by ID | GET /crypto/v2/orders/{orderAnyId} |
If your flow is fully automated with synthetics, conversion can be embedded in ramp orchestration. See Ramps Overview.
Updated 27 days ago