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:

  1. Read spot or reference prices.
  2. Lock a price for a specific pair.
  3. Create an order against the lock.
  4. Read the result: the order comes back COMPLETED in 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 typeTTL
Standard20 seconds
CustomExpiration 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

StatusDescription
COMPLETEDConversion done; resulting amount credited to user balance. This is the normal response to a successful order.
CANCELLEDThe 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, where 0.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

internalStatusHTTPDescription
INVALID_PARAMS400Missing or invalid request parameters
NO_FUNDS400User has insufficient balance
EXPIRED_PRICE400Price lock has expired
MIN_SIZE400Order is below the 0.1 USD minimum
INVALID_COIN400Asset is not supported
INVALID_COIN_COUNTRY400Asset not available in the user's country
BLOCKED_UIF400User has exhausted their operation limits
IS_PEP400User requires PEP documentation before operating
USER_NF404User not found
PRICE_NF404Price not found for the requested pair
USER_BLOCKED409User account is blocked
USER_NOT_VALIDATED409User has not completed onboarding
ORDER_EXISTS409An order with this externalId already exists
OPERATION_BLOCKED409Operation is blocked by policy or limits

For idempotency using externalId, see Errors and controls.


Endpoint references

If your flow is fully automated with synthetics, conversion can be embedded in ramp orchestration. See Ramps Overview.


Did this page help you?