{
 "info": {
  "name": "ArandixBit API (2026-10-22)",
  "description": "Generated from openapi-public.yaml. Set api_key and api_secret; signed requests are signed by the collection pre-request script (HMAC-SHA256).",
  "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
 },
 "event": [
  {
   "listen": "prerequest",
   "script": {
    "type": "text/javascript",
    "exec": [
     "// ArandixBit request signing (X-ARX-*).",
     "// sig = hex(HMAC-SHA256(api_secret, timestamp + METHOD + path_with_query + body))",
     "if (!pm.request.headers.has('X-ARX-SIGNATURE')) { return; }",
     "const secret = pm.variables.get('api_secret');",
     "if (!secret) { throw new Error('Set the api_secret collection variable.'); }",
     "const ts = String(Date.now());",
     "const full = pm.variables.replaceIn(pm.request.url.toString());",
     "const m = full.match(/^[a-z]+:\\/\\/[^/?#]+([^#]*)/i);",
     "let pathWithQuery = m ? m[1] : full;",
     "if (!pathWithQuery.startsWith('/')) { pathWithQuery = '/' + pathWithQuery; }",
     "const body = (pm.request.body && pm.request.body.mode === 'raw') ? pm.variables.replaceIn(pm.request.body.raw || '') : '';",
     "const sig = CryptoJS.HmacSHA256(ts + pm.request.method.toUpperCase() + pathWithQuery + body, secret).toString(CryptoJS.enc.Hex);",
     "pm.request.headers.upsert({ key: 'X-ARX-APIKEY', value: pm.variables.get('api_key') || '' });",
     "pm.request.headers.upsert({ key: 'X-ARX-TIMESTAMP', value: ts });",
     "pm.request.headers.upsert({ key: 'X-ARX-SIGNATURE', value: sig });"
    ]
   }
  }
 ],
 "variable": [
  {
   "key": "base_url",
   "value": "https://api-sandbox.arandixbit.com"
  },
  {
   "key": "api_key",
   "value": ""
  },
  {
   "key": "api_secret",
   "value": ""
  },
  {
   "key": "access_token",
   "value": ""
  },
  {
   "key": "cid",
   "value": "00000000-0000-4000-8000-000000000501"
  },
  {
   "key": "client_order_id",
   "value": "bot-42"
  },
  {
   "key": "id",
   "value": "3f6c2a1e-8d4b-4c1a-9f2e-7b5d0c9a1e42"
  },
  {
   "key": "symbol",
   "value": "BTC"
  },
  {
   "key": "token",
   "value": ""
  }
 ],
 "item": [
  {
   "name": "Market",
   "description": "Public market data, server time and the market-data WebSocket. No authentication.",
   "item": [
    {
     "name": "Get server time",
     "request": {
      "method": "GET",
      "header": [],
      "url": {
       "raw": "{{base_url}}/v1/public/time",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "public",
        "time"
       ],
       "query": []
      },
      "description": "Get server time\n\nCurrent server time, for synchronizing the clock used in `X-ARX-TIMESTAMP`\n(signed requests must be within ±10 s). No authentication; limited per IP;\nnever cached (`Cache-Control: no-store`)."
     }
    },
    {
     "name": "Get local currency quotes",
     "request": {
      "method": "GET",
      "header": [],
      "url": {
       "raw": "{{base_url}}/v1/public/local-quotes",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "public",
        "local-quotes"
       ],
       "query": []
      },
      "description": "Get local currency quotes\n\nReference, buying and selling prices of the local currency pairs (USDT/PYG, BRL/PYG, USDT/BRL).\nNo authentication; limited per IP; the answer can be up to 30 s old. A conversion or Paraguay\npayout quote is the price that applies to an order."
     }
    },
    {
     "name": "List reference tickers",
     "request": {
      "method": "GET",
      "header": [],
      "url": {
       "raw": "{{base_url}}/v1/public/markets",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "public",
        "markets"
       ],
       "query": []
      },
      "description": "List reference tickers\n\nUSD reference tickers for the main crypto assets (display prices from an external reference feed, not the ArandixBit order book)."
     }
    },
    {
     "name": "List fees",
     "request": {
      "method": "GET",
      "header": [],
      "url": {
       "raw": "{{base_url}}/v1/public/fees",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "public",
        "fees"
       ],
       "query": []
      },
      "description": "List fees\n\nActive fees (basis points with min/max in minor units) and VIP tiers, exactly as configured. Cached for 5 minutes."
     }
    },
    {
     "name": "List plans, limits and fees",
     "request": {
      "method": "GET",
      "header": [],
      "url": {
       "raw": "{{base_url}}/v1/public/plans",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "public",
        "plans"
       ],
       "query": []
      },
      "description": "List plans, limits and fees\n\nVerification levels (plans) with their limits (USD cents, `0` = unlimited), Convert\nfees, spot fees and the crypto withdrawal fee rule per network (fixed, or\ncost-plus: live network cost + `markup_usd`, between `min_usd` and `max_usd`).\nCached for 60 s; limited per IP."
     }
    },
    {
     "name": "Verify an official channel",
     "request": {
      "method": "GET",
      "header": [],
      "url": {
       "raw": "{{base_url}}/v1/public/verify?q=arandixbit.com",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "public",
        "verify"
       ],
       "query": [
        {
         "key": "q",
         "value": "arandixbit.com",
         "disabled": false,
         "description": "URL/domain, email address or phone number."
        }
       ]
      },
      "description": "Verify an official channel\n\nAnti-phishing check: tells whether a website, email address or phone number\n(WhatsApp) is an official ArandixBit channel. The query is normalized (host without\nscheme/path/`www.`, lower-case email, digits-only phone) and look-alike domains are\nreported as not official. Limited per IP."
     }
    },
    {
     "name": "List spot symbols (public)",
     "request": {
      "method": "GET",
      "header": [],
      "url": {
       "raw": "{{base_url}}/v1/public/symbols",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "public",
        "symbols"
       ],
       "query": []
      },
      "description": "List spot symbols (public)\n\nSame data and format as `GET /v1/spot/symbols`, without authentication. Cached for 1 s; limited per IP."
     }
    },
    {
     "name": "Get order book (public)",
     "request": {
      "method": "GET",
      "header": [],
      "url": {
       "raw": "{{base_url}}/v1/public/book?symbol=BTC/USDT",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "public",
        "book"
       ],
       "query": [
        {
         "key": "symbol",
         "value": "BTC/USDT",
         "disabled": false,
         "description": "Spot symbol exactly as listed by `/v1/spot/symbols` (for example `BTC/USDT`; URL-encode the slash as `%2F`)."
        },
        {
         "key": "depth",
         "value": "20",
         "disabled": true,
         "description": "Levels per side."
        }
       ]
      },
      "description": "Get order book (public)\n\nAggregated spot order book, same format as `GET /v1/spot/book` (no order or user data). Cached for 1 s per symbol and depth; limited per IP."
     }
    },
    {
     "name": "List recent trades (public)",
     "request": {
      "method": "GET",
      "header": [],
      "url": {
       "raw": "{{base_url}}/v1/public/trades?symbol=BTC/USDT",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "public",
        "trades"
       ],
       "query": [
        {
         "key": "symbol",
         "value": "BTC/USDT",
         "disabled": false,
         "description": "Spot symbol exactly as listed by `/v1/spot/symbols` (for example `BTC/USDT`; URL-encode the slash as `%2F`)."
        },
        {
         "key": "limit",
         "value": "40",
         "disabled": true,
         "description": "Number of trades (1–40)."
        }
       ]
      },
      "description": "List recent trades (public)\n\nRecent spot trades, same format as `GET /v1/spot/trades` (no order or user data). Cached for 1 s per symbol and limit; limited per IP."
     }
    },
    {
     "name": "List reference candles",
     "request": {
      "method": "GET",
      "header": [],
      "url": {
       "raw": "{{base_url}}/v1/public/candles/{{symbol}}",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "public",
        "candles",
        "{{symbol}}"
       ],
       "query": [
        {
         "key": "interval",
         "value": "1h",
         "disabled": true,
         "description": "Candle interval."
        },
        {
         "key": "limit",
         "value": "60",
         "disabled": true,
         "description": "Number of candles (values above 120 are capped)."
        }
       ]
      },
      "description": "List reference candles\n\nOHLCV candles against USDT from the reference feed (display prices). Cached for 60 s; limited per IP."
     }
    }
   ]
  },
  {
   "name": "Account",
   "description": "Balances, portfolio, plan limits, fees, unified history and ledger statement (`account.read`).",
   "item": [
    {
     "name": "Get balances",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/balances",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "balances"
       ],
       "query": []
      },
      "description": "Get balances\n\nBalances of every currency and wallet (`funding`, `spot`, `p2p`, `earn`) in minor\nunits. A `funding` balance exists for every listed currency (zero when unused).\n`held` is reserved by open orders, pending withdrawals or conversions."
     }
    },
    {
     "name": "Get portfolio value",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/portfolio",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "portfolio"
       ],
       "query": []
      },
      "description": "Get portfolio value\n\nAggregated holdings per currency with an indicative USD valuation. USD values are floats for display only."
     }
    },
    {
     "name": "Get plan limits and usage",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/me/limits",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "me",
        "limits"
       ],
       "query": []
      },
      "description": "Get plan limits and usage\n\nVerification level, plan limits and current usage, all in USD cents (`0` = unlimited).\n\n- `deposit`: plan deposit limit with usage and remaining amount. `daily` is a rolling\n  24 h window, `monthly` the calendar month (UTC). Usage counts pending and credited\n  fiat deposits plus credited crypto deposits. The limit is **enforced on fiat\n  deposits only** (`409 deposit_limit_exceeded`); on-chain crypto deposits are never\n  refused, only flagged.\n- `convert`: Convert allowance per class (`crypto`, `fiat`).\n- `limits`: the raw plan limits; `usage`: withdrawal and deposit usage today and in\n  the last 30 days."
     }
    },
    {
     "name": "Get applicable fees",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/me/fees",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "me",
        "fees"
       ],
       "query": []
      },
      "description": "Get applicable fees\n\nFees that apply to the account right now — the same values the platform charges:\nConvert by plan (crypto and fiat), spot maker/taker and P2P. Accounts in a **fee\ngroup** (contract pricing; a partner's sub-accounts inherit the partner's group) also\nget `fee_group`, whose PIX, Convert, crypto and Paraguay-payout rates replace the\nplan's. Percentages in `*_cbps` are hundredths of a basis point (1 % = 10000)."
     }
    },
    {
     "name": "List unified history",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/history",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "history"
       ],
       "query": [
        {
         "key": "type",
         "value": "deposit",
         "disabled": true,
         "description": "Only items of this type. Omit for all types."
        },
        {
         "key": "from",
         "value": "2026-10-01T00:00:00Z",
         "disabled": true,
         "description": "Start of the period (inclusive), RFC 3339 or epoch milliseconds. Default: `to` minus 90 days."
        },
        {
         "key": "to",
         "value": "2026-10-01T00:00:00Z",
         "disabled": true,
         "description": "End of the period (exclusive), RFC 3339 or epoch milliseconds. Default: now. Maximum window: 366 days."
        },
        {
         "key": "cursor",
         "value": "",
         "disabled": true,
         "description": "Opaque `next_cursor` from the previous page. Send the same filters as the first request."
        },
        {
         "key": "limit",
         "value": "50",
         "disabled": true,
         "description": "Page size (default 50, maximum 200)."
        }
       ]
      },
      "description": "List unified history\n\nDeposits, withdrawals, conversions and spot trades of the account in one list,\nnewest first, paginated by cursor. Default period: the last 90 days; maximum\nwindow 366 days."
     }
    },
    {
     "name": "Get account statement",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/statement",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "statement"
       ],
       "query": [
        {
         "key": "type",
         "value": "deposit",
         "disabled": true,
         "description": "Only lines of this type. `fee` returns only the fee lines."
        },
        {
         "key": "currency",
         "value": "BRL",
         "disabled": true,
         "description": "Only lines in this currency (2–10 upper-case letters/digits)."
        },
        {
         "key": "from",
         "value": "2026-10-01T00:00:00Z",
         "disabled": true,
         "description": "Start of the period (inclusive), RFC 3339 or epoch milliseconds. Default: `to` minus 90 days."
        },
        {
         "key": "to",
         "value": "2026-10-01T00:00:00Z",
         "disabled": true,
         "description": "End of the period (exclusive), RFC 3339 or epoch milliseconds. Default: now. Maximum window: 366 days."
        },
        {
         "key": "cursor",
         "value": "",
         "disabled": true,
         "description": "Opaque `next_cursor` from the previous page. Send the same filters as the first request."
        },
        {
         "key": "limit",
         "value": "",
         "disabled": true,
         "description": "Number of ledger entries per page. JSON: default 100, maximum 500. CSV: default 1000, maximum 5000. An entry with a fee produces two lines."
        },
        {
         "key": "format",
         "value": "json",
         "disabled": true,
         "description": "`json` (default) or `csv`."
        }
       ]
      },
      "description": "Get account statement\n\nLedger lines of the account (session or `account.read` key; a sub-account\nrestricted key reads its sub-account). Newest first, paginated by cursor.\n`limit` counts ledger entries: an entry with a fee produces two lines (the gross\nprincipal and a separate `fee` line). `format=csv` returns CSV with the next\ncursor in `X-Next-Cursor`. See *Statement* in the introduction."
     }
    }
   ]
  },
  {
   "name": "Spot",
   "description": "Spot trading on the ArandixBit order book (`spot.read` / `spot.trade`). Trading requires approved KYC.",
   "item": [
    {
     "name": "List spot symbols",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/spot/symbols",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "spot",
        "symbols"
       ],
       "query": []
      },
      "description": "List spot symbols\n\nTradable symbols with base/quote exponents and the maker/taker fees actually charged."
     }
    },
    {
     "name": "Get order book",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/spot/book?symbol=BTC/USDT",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "spot",
        "book"
       ],
       "query": [
        {
         "key": "symbol",
         "value": "BTC/USDT",
         "disabled": false,
         "description": "Spot symbol exactly as listed by `/v1/spot/symbols` (for example `BTC/USDT`; URL-encode the slash as `%2F`)."
        }
       ]
      },
      "description": "Get order book\n\nAggregated order book (20 levels per side). Prices in quote minor units per whole base unit; amounts in base minor units."
     }
    },
    {
     "name": "List recent trades",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/spot/trades?symbol=BTC/USDT",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "spot",
        "trades"
       ],
       "query": [
        {
         "key": "symbol",
         "value": "BTC/USDT",
         "disabled": false,
         "description": "Spot symbol exactly as listed by `/v1/spot/symbols` (for example `BTC/USDT`; URL-encode the slash as `%2F`)."
        }
       ]
      },
      "description": "List recent trades\n\nThe 40 most recent trades of a symbol, newest first."
     }
    },
    {
     "name": "List your orders",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/spot/orders",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "spot",
        "orders"
       ],
       "query": [
        {
         "key": "open",
         "value": "1",
         "disabled": true,
         "description": "Set to `1` to return only open orders (`pending`, `open`, `partial`)."
        },
        {
         "key": "client_order_id",
         "value": "",
         "disabled": true,
         "description": "Return only the order with this `client_order_id` (0 or 1 result)."
        }
       ]
      },
      "description": "List your orders\n\nYour 100 most recent spot orders, newest first. `open=1` returns only working\norders. `client_order_id` looks up a single order by your id and returns a list\nwith zero or one element."
     }
    },
    {
     "name": "Create an order",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Idempotency-Key",
        "value": "{{$guid}}",
        "description": "Optional client-generated key that makes the request safe to retry\n(1–100 characters `[A-Za-z0-9_.:-]`; malformed → `400 idempotency_key_invalid`).\nScoped to the authenticated account. Two modes (see *Idempotency*):\n\n- **Stored-response mode** (spot orders/cancellations, Convert cancellation,\n  deposit creation, webhook endpoint and sub-account creation): kept 24 h; same\n  key + same request → the stored response is replayed with\n  `Idempotent-Replayed: true`; same key + different request → `409\n  idempotency_key_reused`; first request still running → `409\n  idempotency_request_in_progress`. Only 2xx/4xx responses (except 429) are\n  stored, so retrying a 5xx with the same key is safe.\n- **Permanent mode** (Convert execution and crypto withdrawals): the key must be\n  8–100 characters (shorter → `400 bad_request`); a retry returns the same\n  conversion (`replayed: true`) or withdrawal (`duplicate: true`) with\n  `Idempotent-Replayed: true`, without expiry; same key with different data →\n  `409 idempotency_conflict`; concurrent retry → `409 idempotency_request_in_progress`."
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/spot/orders",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "spot",
        "orders"
       ],
       "query": []
      },
      "description": "Create an order\n\nPlaces a spot order. Requires approved KYC. Funds are reserved (`held`) in the\n`spot` wallet: the quote amount for buys (for market buys, the reference price\nplus 10 %), the base amount for sells.\n\n| `type` | Required fields | Behavior |\n|---|---|---|\n| `limit` | `price`, `amount` | Rests on the book until filled or cancelled. |\n| `market` | `amount` | Fills immediately against the book (or routed liquidity). |\n| `stop_limit` | `stop_price`, `price`, `amount` | Places a limit order when the last price crosses `stop_price`. |\n| `oco` | `price`, `stop_price`, `stop_limit_price`, `amount` | Take-profit limit + stop-limit; one cancels the other. |\n| `trailing_stop` | `trail_bps`, `amount` | Stop that follows the price at `trail_bps` distance. |\n\nUse `client_order_id` to tag the order with your own id: duplicates are rejected\nwith `409 duplicate_client_order_id`; an invalid value returns `400 bad_request`\nwith `details.client_order_id`. Combine it with `Idempotency-Key` for safe retries.\n\nA market order routed to external liquidity may answer `202 settlement_pending`\n(error envelope) when the trade executed but internal settlement is being\nreconciled; the balance is adjusted shortly.",
      "body": {
       "mode": "raw",
       "raw": "{\"symbol\":\"BTC/USDT\",\"side\":\"buy\",\"type\":\"limit\",\"price\":62450120000,\"amount\":150000,\"client_order_id\":\"bot-42\"}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Cancel an order",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Idempotency-Key",
        "value": "{{$guid}}",
        "description": "Optional client-generated key that makes the request safe to retry\n(1–100 characters `[A-Za-z0-9_.:-]`; malformed → `400 idempotency_key_invalid`).\nScoped to the authenticated account. Two modes (see *Idempotency*):\n\n- **Stored-response mode** (spot orders/cancellations, Convert cancellation,\n  deposit creation, webhook endpoint and sub-account creation): kept 24 h; same\n  key + same request → the stored response is replayed with\n  `Idempotent-Replayed: true`; same key + different request → `409\n  idempotency_key_reused`; first request still running → `409\n  idempotency_request_in_progress`. Only 2xx/4xx responses (except 429) are\n  stored, so retrying a 5xx with the same key is safe.\n- **Permanent mode** (Convert execution and crypto withdrawals): the key must be\n  8–100 characters (shorter → `400 bad_request`); a retry returns the same\n  conversion (`replayed: true`) or withdrawal (`duplicate: true`) with\n  `Idempotent-Replayed: true`, without expiry; same key with different data →\n  `409 idempotency_conflict`; concurrent retry → `409 idempotency_request_in_progress`."
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/spot/orders/{{id}}/cancel",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "spot",
        "orders",
        "{{id}}",
        "cancel"
       ],
       "query": []
      },
      "description": "Cancel an order\n\nCancels an open order and releases its reserved funds. Cancelling one leg of an\nOCO cancels the other leg too. Returns `404 not_found` for unknown orders or\norders of another account and `409 conflict` when the order is no longer open."
     }
    },
    {
     "name": "Cancel an order by client order id",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Idempotency-Key",
        "value": "{{$guid}}",
        "description": "Optional client-generated key that makes the request safe to retry\n(1–100 characters `[A-Za-z0-9_.:-]`; malformed → `400 idempotency_key_invalid`).\nScoped to the authenticated account. Two modes (see *Idempotency*):\n\n- **Stored-response mode** (spot orders/cancellations, Convert cancellation,\n  deposit creation, webhook endpoint and sub-account creation): kept 24 h; same\n  key + same request → the stored response is replayed with\n  `Idempotent-Replayed: true`; same key + different request → `409\n  idempotency_key_reused`; first request still running → `409\n  idempotency_request_in_progress`. Only 2xx/4xx responses (except 429) are\n  stored, so retrying a 5xx with the same key is safe.\n- **Permanent mode** (Convert execution and crypto withdrawals): the key must be\n  8–100 characters (shorter → `400 bad_request`); a retry returns the same\n  conversion (`replayed: true`) or withdrawal (`duplicate: true`) with\n  `Idempotent-Replayed: true`, without expiry; same key with different data →\n  `409 idempotency_conflict`; concurrent retry → `409 idempotency_request_in_progress`."
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/spot/orders/by-client-id/{{client_order_id}}/cancel",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "spot",
        "orders",
        "by-client-id",
        "{{client_order_id}}",
        "cancel"
       ],
       "query": []
      },
      "description": "Cancel an order by client order id\n\nSame as `POST /v1/spot/orders/{id}/cancel`, addressing the order by your\n`client_order_id`. `404 not_found` when no order of the account has that id;\n`409 conflict` when the order is no longer open."
     }
    }
   ]
  },
  {
   "name": "Convert",
   "description": "Instant conversions between crypto and fiat (`convert.read` / `convert.execute`). Conversions involving fiat wait for staff approval.",
   "item": [
    {
     "name": "List Convert currencies",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/convert/pairs",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "convert",
        "pairs"
       ],
       "query": []
      },
      "description": "List Convert currencies\n\nCurrencies available to Convert (`active` or `integration`), plus the plan fees and allowances of the account."
     }
    },
    {
     "name": "Get a Convert quote",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/convert/quote?from=USDT&to=BTC&amount=100000000",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "convert",
        "quote"
       ],
       "query": [
        {
         "key": "from",
         "value": "USDT",
         "disabled": false,
         "description": "Currency you pay."
        },
        {
         "key": "to",
         "value": "BTC",
         "disabled": false,
         "description": "Currency you receive."
        },
        {
         "key": "amount",
         "value": "100000000",
         "disabled": false,
         "description": "Amount of `from` in minor units."
        },
        {
         "key": "min_receive",
         "value": "1000000",
         "disabled": true,
         "description": "Optional minimum amount of `to` in minor units."
        }
       ]
      },
      "description": "Get a Convert quote\n\nLive quote: route (house liquidity, Pool ArandixBit or a mix; fiat legs for BRL/PYG), fee,\nspread, estimated and worst-case output, minimum amount and the plan allowance.\nThe returned `quote_id` can be executed with `POST /v1/convert` until `expires_at`\n(about 15 s). Conversions involving PYG use the live exchange-house price: the buying price when you\nreceive PYG and the selling price when you give PYG, plus your plan fee. With no selling price\navailable, giving PYG answers `503 price_unavailable`. Limited to 60 quotes per minute per account."
     }
    },
    {
     "name": "Get a Convert quote (JSON body)",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/convert/quote",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "convert",
        "quote"
       ],
       "query": []
      },
      "description": "Get a Convert quote (JSON body)\n\nLive quote: route (house liquidity, Pool ArandixBit or a mix; fiat legs for BRL/PYG), fee,\nspread, estimated and worst-case output, minimum amount and the plan allowance.\nThe returned `quote_id` can be executed with `POST /v1/convert` until `expires_at`\n(about 15 s). Conversions involving PYG use the live exchange-house price: the buying price when you\nreceive PYG and the selling price when you give PYG, plus your plan fee. With no selling price\navailable, giving PYG answers `503 price_unavailable`. Limited to 60 quotes per minute per account.",
      "body": {
       "mode": "raw",
       "raw": "{\"from\":\"USDT\",\"to\":\"BTC\",\"amount\":100000000}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Execute a conversion",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Idempotency-Key",
        "value": "{{$guid}}",
        "description": "Optional client-generated key that makes the request safe to retry\n(1–100 characters `[A-Za-z0-9_.:-]`; malformed → `400 idempotency_key_invalid`).\nScoped to the authenticated account. Two modes (see *Idempotency*):\n\n- **Stored-response mode** (spot orders/cancellations, Convert cancellation,\n  deposit creation, webhook endpoint and sub-account creation): kept 24 h; same\n  key + same request → the stored response is replayed with\n  `Idempotent-Replayed: true`; same key + different request → `409\n  idempotency_key_reused`; first request still running → `409\n  idempotency_request_in_progress`. Only 2xx/4xx responses (except 429) are\n  stored, so retrying a 5xx with the same key is safe.\n- **Permanent mode** (Convert execution and crypto withdrawals): the key must be\n  8–100 characters (shorter → `400 bad_request`); a retry returns the same\n  conversion (`replayed: true`) or withdrawal (`duplicate: true`) with\n  `Idempotent-Replayed: true`, without expiry; same key with different data →\n  `409 idempotency_conflict`; concurrent retry → `409 idempotency_request_in_progress`."
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/convert",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "convert"
       ],
       "query": []
      },
      "description": "Execute a conversion\n\nExecutes a conversion from the `funding` wallet. Requires approved KYC. Plan limits\n(per conversion, daily, monthly) apply.\n\n- **Crypto ↔ crypto** executes immediately → `200` with `status: completed` (or\n  `partial`).\n- **Anything involving fiat** (BRL/PYG) is reserved and waits for staff approval\n  (four-eyes) → `202` with `status: pending_approval`. On approval it is re-quoted\n  live and executed only if the result is not below `min_receive`. You receive the\n  `convert.pending_approval`, `convert.completed` or `convert.rejected` webhooks.\n- `202` is also returned while an execution is `executing` or under `review`.\n\nPass `quote_id` to execute at a recent quote, or `min_receive` to bound slippage.\nIdempotent (permanent mode) by the `Idempotency-Key` header or the `idempotency_key`\nbody field (8–100 characters; the body wins): a retry returns the original\nconversion with `replayed: true` and the header `Idempotent-Replayed: true`; the same\nkey with different data returns `409 idempotency_conflict`. Conversions\nwith PYG use the exchange-house buying price when you receive PYG and the selling price when you\ngive PYG; with no selling price, giving PYG answers `503 price_unavailable`.",
      "body": {
       "mode": "raw",
       "raw": "{\"from\":\"USDT\",\"to\":\"BTC\",\"amount\":100000000,\"quote_id\":\"00000000-0000-4000-8000-000000000651\"}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "List your conversions",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/convert/orders",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "convert",
        "orders"
       ],
       "query": []
      },
      "description": "List your conversions\n\nYour 50 most recent conversions, newest first."
     }
    },
    {
     "name": "Get a conversion",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/convert/orders/{{id}}",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "convert",
        "orders",
        "{{id}}"
       ],
       "query": []
      },
      "description": "Get a conversion\n\nOne of your conversions. Conversions of other accounts return `404`."
     }
    },
    {
     "name": "Cancel a pending conversion",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Idempotency-Key",
        "value": "{{$guid}}",
        "description": "Optional client-generated key that makes the request safe to retry\n(1–100 characters `[A-Za-z0-9_.:-]`; malformed → `400 idempotency_key_invalid`).\nScoped to the authenticated account. Two modes (see *Idempotency*):\n\n- **Stored-response mode** (spot orders/cancellations, Convert cancellation,\n  deposit creation, webhook endpoint and sub-account creation): kept 24 h; same\n  key + same request → the stored response is replayed with\n  `Idempotent-Replayed: true`; same key + different request → `409\n  idempotency_key_reused`; first request still running → `409\n  idempotency_request_in_progress`. Only 2xx/4xx responses (except 429) are\n  stored, so retrying a 5xx with the same key is safe.\n- **Permanent mode** (Convert execution and crypto withdrawals): the key must be\n  8–100 characters (shorter → `400 bad_request`); a retry returns the same\n  conversion (`replayed: true`) or withdrawal (`duplicate: true`) with\n  `Idempotent-Replayed: true`, without expiry; same key with different data →\n  `409 idempotency_conflict`; concurrent retry → `409 idempotency_request_in_progress`."
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/convert/orders/{{id}}/cancel",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "convert",
        "orders",
        "{{id}}",
        "cancel"
       ],
       "query": []
      },
      "description": "Cancel a pending conversion\n\nCancels a conversion that is still `pending_approval` and releases the reserved amount. Already decided conversions return `409 not_pending`."
     }
    }
   ]
  },
  {
   "name": "Wallet",
   "description": "Deposits (USDT, on-chain, fiat, PIX), withdrawals (crypto, including USDT, via `POST /v1/mexc/withdrawals`) and the withdrawal whitelist (`wallet.read` / `wallet.withdraw`).",
   "item": [
    {
     "name": "Get deposit and withdrawal rails",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/rails/config",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "rails",
        "config"
       ],
       "query": []
      },
      "description": "Get deposit and withdrawal rails\n\nWhich deposit/withdrawal rails are enabled. Crypto deposits use a **fixed deposit\naddress per account** (`mexc_deposit`: coins and networks — see\n`GET /v1/crypto/fixed-address`); crypto withdrawals, USDT included, go through\n`POST /v1/mexc/withdrawals` (`mexc_withdraw`). The legacy USDT order rail (`usdt`)\nis paused: `deposit_paused: true` and empty network lists. Disabled\nrails come back with `enabled: false` and empty lists."
     }
    },
    {
     "name": "Get your fixed deposit address",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/crypto/fixed-address?coin=USDT&network=Tron(TRC20)",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "crypto",
        "fixed-address"
       ],
       "query": [
        {
         "key": "coin",
         "value": "USDT",
         "disabled": false,
         "description": "Coin."
        },
        {
         "key": "network",
         "value": "Tron(TRC20)",
         "disabled": false,
         "description": "Network name from `mexc_deposit.networks`."
        }
       ]
      },
      "description": "Get your fixed deposit address\n\nReturns the account's **fixed deposit address** for the coin and network (created on the\nfirst call, then always the same — like on large exchanges). No amount, no expiry: any\ndeposit to it is credited automatically once the network/provider confirms it, exactly\nonce per transaction, and fires the `deposit.credited` webhook (`rail: \"mexc\"`, with\n`txid` and `address`). Requires approved KYC. Networks come from\n`GET /v1/rails/config` → `mexc_deposit.networks`; unknown network → `400`; network with\ndeposits suspended by the provider (`deposit_enabled: false`) → `503 crypto_deposit_network_suspended`;\nnetwork that has no address left for a new account (`pool_full: true`) → `503 crypto_deposit_network_full`:\noffer another network. Temporary provider failure → `502 crypto_deposit_provider_unavailable`: retry.\nWith an API key the limit is the key quota (`X-RateLimit-*`), not a limit per IP, so a partner can\ncreate addresses for many sub-accounts from one IP."
     }
    },
    {
     "name": "List deposits to your fixed addresses",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/crypto/fixed-deposits",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "crypto",
        "fixed-deposits"
       ],
       "query": []
      },
      "description": "List deposits to your fixed addresses\n\nDeposits received at the account's fixed addresses (newest first, up to 50) and the\naddresses already assigned. `confirming` = seen on the network, not yet credited;\n`credited` = balance available; `rejected` = refused by the provider (never credited). `below_min` = confirmed but under the minimum deposit (`mexc_deposit.min_usd` in `/v1/rails/config`): not credited, support decides."
     }
    },
    {
     "name": "List USDT deposit orders",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/usdt/deposits",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "usdt",
        "deposits"
       ],
       "query": []
      },
      "description": "List USDT deposit orders\n\nYour USDT deposit orders (legacy order rail, paused), newest first."
     }
    },
    {
     "name": "Create a USDT deposit order",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Idempotency-Key",
        "value": "{{$guid}}",
        "description": "Optional client-generated key that makes the request safe to retry\n(1–100 characters `[A-Za-z0-9_.:-]`; malformed → `400 idempotency_key_invalid`).\nScoped to the authenticated account. Two modes (see *Idempotency*):\n\n- **Stored-response mode** (spot orders/cancellations, Convert cancellation,\n  deposit creation, webhook endpoint and sub-account creation): kept 24 h; same\n  key + same request → the stored response is replayed with\n  `Idempotent-Replayed: true`; same key + different request → `409\n  idempotency_key_reused`; first request still running → `409\n  idempotency_request_in_progress`. Only 2xx/4xx responses (except 429) are\n  stored, so retrying a 5xx with the same key is safe.\n- **Permanent mode** (Convert execution and crypto withdrawals): the key must be\n  8–100 characters (shorter → `400 bad_request`); a retry returns the same\n  conversion (`replayed: true`) or withdrawal (`duplicate: true`) with\n  `Idempotent-Replayed: true`, without expiry; same key with different data →\n  `409 idempotency_conflict`; concurrent retry → `409 idempotency_request_in_progress`."
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/usdt/deposits",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "usdt",
        "deposits"
       ],
       "query": []
      },
      "description": "Create a USDT deposit order\n\n**Paused** (`503 usdt_deposit_paused`): use your fixed deposit address\n(`GET /v1/crypto/fixed-address`) instead. Kept for orders already open.\n\nCreates (or reuses an identical open) USDT deposit order and returns the address and\nthe **exact** amount to send. Requires approved KYC. Credit happens automatically\nwhen the provider confirms the transfer (`deposit.credited` webhook).\n\n`200` = order open (`reused: true` when an identical open order was returned);\n`202` = order still being created at the provider — poll `GET /v1/usdt/deposits/{id}`.",
      "body": {
       "mode": "raw",
       "raw": "{\"asset\":\"USDTTRC20\",\"amount\":250000000}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Get a USDT deposit order",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/usdt/deposits/{{id}}",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "usdt",
        "deposits",
        "{{id}}"
       ],
       "query": []
      },
      "description": "Get a USDT deposit order\n\nOne of your USDT deposit orders."
     }
    },
    {
     "name": "Quote a USDT withdrawal",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/usdt/withdrawals/quote?asset=USDTTRC20&amount=500000000",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "usdt",
        "withdrawals",
        "quote"
       ],
       "query": [
        {
         "key": "asset",
         "value": "USDTTRC20",
         "disabled": false,
         "description": "USDT network code."
        },
        {
         "key": "amount",
         "value": "500000000",
         "disabled": false,
         "description": "Amount the destination receives, USDT minor units."
        }
       ]
      },
      "description": "Quote a USDT withdrawal\n\nFee for a USDT withdrawal on a network (fixed per network or cost-plus). The returned\n`quote_id` locks the fee for `ttl_sec` seconds when passed to `POST /v1/usdt/withdrawals`."
     }
    },
    {
     "name": "Withdraw USDT",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Idempotency-Key",
        "value": "{{$guid}}",
        "description": "Optional client-generated key that makes the request safe to retry\n(1–100 characters `[A-Za-z0-9_.:-]`; malformed → `400 idempotency_key_invalid`).\nScoped to the authenticated account. Two modes (see *Idempotency*):\n\n- **Stored-response mode** (spot orders/cancellations, Convert cancellation,\n  deposit creation, webhook endpoint and sub-account creation): kept 24 h; same\n  key + same request → the stored response is replayed with\n  `Idempotent-Replayed: true`; same key + different request → `409\n  idempotency_key_reused`; first request still running → `409\n  idempotency_request_in_progress`. Only 2xx/4xx responses (except 429) are\n  stored, so retrying a 5xx with the same key is safe.\n- **Permanent mode** (Convert execution and crypto withdrawals): the key must be\n  8–100 characters (shorter → `400 bad_request`); a retry returns the same\n  conversion (`replayed: true`) or withdrawal (`duplicate: true`) with\n  `Idempotent-Replayed: true`, without expiry; same key with different data →\n  `409 idempotency_conflict`; concurrent retry → `409 idempotency_request_in_progress`."
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/usdt/withdrawals",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "usdt",
        "withdrawals"
       ],
       "query": []
      },
      "description": "Withdraw USDT\n\n**Moved** (`503 usdt_withdraw_moved`): USDT withdrawals now use `POST /v1/mexc/withdrawals` with `coin: \"USDT\"`.\n\n**Rules**\n\n- With an API key (`wallet.withdraw`, IP allow-list required): only to an address on\n  the account whitelist whose security cooldown has elapsed\n  (`422 address_not_whitelisted` / `422 address_cooldown`); no `code` needed.\n- With a session: `code` (TOTP) is required when 2FA is enabled.\n- Approved KYC, the 24 h security lock after a password/2FA change\n  (`403 security_lock`), plan limits (per transaction, daily, monthly) and the network\n  fee apply. Above the automatic threshold the withdrawal waits for four-eyes review\n  (`auto: false`), with the amount reserved.\n- `amount` is what the destination receives; `debit = amount + fee`.\n- Fee protection: send `quote_id` (from the quote endpoint) and/or `max_fee` (minor\n  units). If the current fee is higher, nothing is debited and the API answers\n  `409 withdraw_fee_changed` with `details.fee`.\n- Idempotency (permanent mode): send `Idempotency-Key` (8–100 characters). A retry\n  returns the **same** withdrawal with `duplicate: true` and the header\n  `Idempotent-Replayed: true`, without time limit; the same key with different data\n  returns `409 idempotency_conflict`; a concurrent retry returns\n  `409 idempotency_request_in_progress`.",
      "body": {
       "mode": "raw",
       "raw": "{\"asset\":\"USDTTRC20\",\"amount\":500000000,\"to_address\":\"TXexampleAddressDoNotUse000000000000\",\"quote_id\":\"00000000-0000-4000-8000-000000000751\",\"max_fee\":2000000}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Quote a crypto withdrawal (Pool ArandixBit)",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/mexc/withdrawals/quote?coin=BTC&network=BTC&amount=1000000",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "mexc",
        "withdrawals",
        "quote"
       ],
       "query": [
        {
         "key": "coin",
         "value": "BTC",
         "disabled": false,
         "description": "Coin, e.g. `BTC`."
        },
        {
         "key": "network",
         "value": "BTC",
         "disabled": false,
         "description": "Network as listed in `/v1/rails/config`."
        },
        {
         "key": "amount",
         "value": "1000000",
         "disabled": false,
         "description": "Amount the destination receives, minor units."
        }
       ]
      },
      "description": "Quote a crypto withdrawal (Pool ArandixBit)\n\nFee, minimum/maximum and memo support for a crypto withdrawal routed through the Pool ArandixBit (BTC, ETH, …)."
     }
    },
    {
     "name": "Withdraw crypto (Pool ArandixBit)",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Idempotency-Key",
        "value": "{{$guid}}",
        "description": "Optional client-generated key that makes the request safe to retry\n(1–100 characters `[A-Za-z0-9_.:-]`; malformed → `400 idempotency_key_invalid`).\nScoped to the authenticated account. Two modes (see *Idempotency*):\n\n- **Stored-response mode** (spot orders/cancellations, Convert cancellation,\n  deposit creation, webhook endpoint and sub-account creation): kept 24 h; same\n  key + same request → the stored response is replayed with\n  `Idempotent-Replayed: true`; same key + different request → `409\n  idempotency_key_reused`; first request still running → `409\n  idempotency_request_in_progress`. Only 2xx/4xx responses (except 429) are\n  stored, so retrying a 5xx with the same key is safe.\n- **Permanent mode** (Convert execution and crypto withdrawals): the key must be\n  8–100 characters (shorter → `400 bad_request`); a retry returns the same\n  conversion (`replayed: true`) or withdrawal (`duplicate: true`) with\n  `Idempotent-Replayed: true`, without expiry; same key with different data →\n  `409 idempotency_conflict`; concurrent retry → `409 idempotency_request_in_progress`."
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/mexc/withdrawals",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "mexc",
        "withdrawals"
       ],
       "query": []
      },
      "description": "Withdraw crypto (Pool ArandixBit)\n\nWithdraws a crypto asset routed through the Pool ArandixBit. Same rules as the USDT withdrawal.\n\n**Rules**\n\n- With an API key (`wallet.withdraw`, IP allow-list required): only to an address on\n  the account whitelist whose security cooldown has elapsed\n  (`422 address_not_whitelisted` / `422 address_cooldown`); no `code` needed.\n- With a session: `code` (TOTP) is required when 2FA is enabled.\n- Approved KYC, the 24 h security lock after a password/2FA change\n  (`403 security_lock`), plan limits (per transaction, daily, monthly) and the network\n  fee apply. Above the automatic threshold the withdrawal waits for four-eyes review\n  (`auto: false`), with the amount reserved.\n- `amount` is what the destination receives; `debit = amount + fee`.\n- Fee protection: send `quote_id` (from the quote endpoint) and/or `max_fee` (minor\n  units). If the current fee is higher, nothing is debited and the API answers\n  `409 withdraw_fee_changed` with `details.fee`.\n- Idempotency (permanent mode): send `Idempotency-Key` (8–100 characters). A retry\n  returns the **same** withdrawal with `duplicate: true` and the header\n  `Idempotent-Replayed: true`, without time limit; the same key with different data\n  returns `409 idempotency_conflict`; a concurrent retry returns\n  `409 idempotency_request_in_progress`.",
      "body": {
       "mode": "raw",
       "raw": "{\"coin\":\"BTC\",\"network\":\"BTC\",\"amount\":1000000,\"to_address\":\"bc1qexampleaddressdonotuse0000000000000\",\"quote_id\":\"00000000-0000-4000-8000-000000000752\",\"max_fee\":6000}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "List crypto withdrawals (rails)",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/rails/withdrawals",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "rails",
        "withdrawals"
       ],
       "query": [
        {
         "key": "rail",
         "value": "dubaicash",
         "disabled": true,
         "description": "Only withdrawals of this rail."
        }
       ]
      },
      "description": "List crypto withdrawals (rails)\n\nYour 50 most recent crypto withdrawals (including legacy USDT order-rail withdrawals), newest first."
     }
    },
    {
     "name": "Cancel a withdrawal",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/rails/withdrawals/{{id}}/cancel",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "rails",
        "withdrawals",
        "{{id}}",
        "cancel"
       ],
       "query": []
      },
      "description": "Cancel a withdrawal\n\nCancels a withdrawal that has not been sent yet (`pending_review` or `queued`) and releases the amount. Requires `wallet.withdraw` (a read-only key cannot cancel)."
     }
    },
    {
     "name": "List on-chain deposits",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/crypto/deposits",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "crypto",
        "deposits"
       ],
       "query": []
      },
      "description": "List on-chain deposits\n\nYour 50 most recent deposits detected on-chain (own custody), newest first."
     }
    },
    {
     "name": "List on-chain withdrawals",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/crypto/withdrawals",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "crypto",
        "withdrawals"
       ],
       "query": []
      },
      "description": "List on-chain withdrawals\n\nYour 50 most recent on-chain withdrawals (own custody), newest first."
     }
    },
    {
     "name": "List whitelisted addresses",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/crypto/whitelist",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "crypto",
        "whitelist"
       ],
       "query": []
      },
      "description": "List whitelisted addresses\n\nWithdrawal addresses on the account whitelist, with the security cooldown (hours)\nand whether the whitelist is enforced for session withdrawals. Addresses are added\nfrom the app (session); API-key withdrawals always require a whitelisted address."
     }
    },
    {
     "name": "List fiat deposits",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/fiat/deposits",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "fiat",
        "deposits"
       ],
       "query": []
      },
      "description": "List fiat deposits\n\nYour 50 most recent fiat deposits. Pending deposits include their payment instructions (PIX code or receiving account)."
     }
    },
    {
     "name": "List fiat withdrawals",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/fiat/withdrawals",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "fiat",
        "withdrawals"
       ],
       "query": []
      },
      "description": "List fiat withdrawals\n\nYour 50 most recent fiat withdrawals."
     }
    },
    {
     "name": "List PIX deposits",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/pix/deposits",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "pix",
        "deposits"
       ],
       "query": []
      },
      "description": "List PIX deposits\n\nYour BRL PIX deposits (up to 100 most recent). Pending ones include their payment instructions (PIX code or receiving account) and the deposit `reference`."
     }
    },
    {
     "name": "Create a PIX deposit charge",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Idempotency-Key",
        "value": "{{$guid}}",
        "description": "Optional client-generated key that makes the request safe to retry\n(1–100 characters `[A-Za-z0-9_.:-]`; malformed → `400 idempotency_key_invalid`).\nScoped to the authenticated account. Two modes (see *Idempotency*):\n\n- **Stored-response mode** (spot orders/cancellations, Convert cancellation,\n  deposit creation, webhook endpoint and sub-account creation): kept 24 h; same\n  key + same request → the stored response is replayed with\n  `Idempotent-Replayed: true`; same key + different request → `409\n  idempotency_key_reused`; first request still running → `409\n  idempotency_request_in_progress`. Only 2xx/4xx responses (except 429) are\n  stored, so retrying a 5xx with the same key is safe.\n- **Permanent mode** (Convert execution and crypto withdrawals): the key must be\n  8–100 characters (shorter → `400 bad_request`); a retry returns the same\n  conversion (`replayed: true`) or withdrawal (`duplicate: true`) with\n  `Idempotent-Replayed: true`, without expiry; same key with different data →\n  `409 idempotency_conflict`; concurrent retry → `409 idempotency_request_in_progress`."
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/pix/deposits",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "pix",
        "deposits"
       ],
       "query": []
      },
      "description": "Create a PIX deposit charge\n\nCreates a BRL deposit by PIX. The credit goes **only** to the account in context. The `auto`\nfield of the response tells which flow applies, and the flow can change without notice, so\nalways branch on it:\n\n**Automatic charge (`auto: true`):** `qr.payload` is a PIX copy-and-paste code for the exact\namount. Pay it before `expires_at`; the credit is automatic after the provider confirms the\npayment (`deposit.credited`). An identical open charge can be returned again (`reused: true`).\nNo service fee, unless the account is in a fee group.\n\n**Manual confirmation (no `auto` field):** the response carries the receiving account\n(`instructions_fields`), a unique `reference` and, when available, a PIX QR of that account\n(`qr`), which may not include the amount. Pay by PIX from an account in the same name and CPF/CNPJ\nas the KYC profile, then send the payment proof with `POST /v1/pix/deposits/{id}/proof` or in the app; the team confirms the deposit (up to\n12 hours) and `deposit.credited` is sent. Fee 0,10% (minimum R$ 1,00), deducted from the credited\namount. With no receiving account the response is `422 method_unavailable`.\n\nThe sandbox has no PIX provider, so it never returns an automatic charge. A fee group can replace\nthe minimum and the fee and can restrict PIX to certain hours.\n\nSame rules in both flows:\n\n- approved KYC of the receiving account; the charge carries the name/document of that\n  account's KYC profile;\n- from R$ 10,00 (`422 pix_amount_out_of_range` on an automatic charge,\n  `422 deposit_below_minimum` on a manual one) to R$ 500.000,00 per PIX\n  (`422 pix_amount_out_of_range`);\n- valid for up to 24 hours; a manual deposit without proof expires after that;\n- up to 5 open charges (`429 pix_too_many_open`);\n- R$ 5.000.000,00 per account per day (`409 pix_daily_limit_exceeded`);\n- plan deposit limit (`409 deposit_limit_exceeded`; `details`: `window`, `level`,\n  `plan`, `limit_usd_minor`, `used_usd_minor`, `remaining_usd_minor`,\n  `amount_usd_minor`).\n\nA PIX returned by the payer's bank or a MED claim produces `deposit.reversed`.",
      "body": {
       "mode": "raw",
       "raw": "{\"amount\":50000}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Send the proof of a manual PIX deposit",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/pix/deposits/{{id}}/proof",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "pix",
        "deposits",
        "{{id}}",
        "proof"
       ],
       "query": []
      },
      "description": "Send the proof of a manual PIX deposit\n\nSends the payment proof of a pending manual PIX deposit of your account, as\n`multipart/form-data` with the `file` field (JPEG, PNG or PDF, up to 10 MB). The team\nthen confirms the deposit and `deposit.credited` is sent. Sign the exact bytes of the\nmultipart body. Sub-accounts use `POST /v1/partner/customers/{cid}/pix/deposits/{id}/proof`."
     }
    },
    {
     "name": "Get a PIX deposit",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/pix/deposits/{{id}}",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "pix",
        "deposits",
        "{{id}}"
       ],
       "query": []
      },
      "description": "Get a PIX deposit\n\nOne PIX deposit of the account in context; any other id returns `404`."
     }
    }
   ]
  },
  {
   "name": "Webhooks",
   "description": "Webhook endpoints, delivery logs, test events and secret rotation (`webhooks`).",
   "item": [
    {
     "name": "List webhook event types",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/webhooks/events",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "webhooks",
        "events"
       ],
       "query": []
      },
      "description": "List webhook event types\n\nEvent types available to the account (partner accounts also get `partner.*`), the payload version, the signature header and the retry schedule (seconds between attempts)."
     }
    },
    {
     "name": "List webhook endpoints",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/webhooks/endpoints",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "webhooks",
        "endpoints"
       ],
       "query": []
      },
      "description": "List webhook endpoints\n\nYour webhook endpoints (secrets are never returned)."
     }
    },
    {
     "name": "Create a webhook endpoint",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Idempotency-Key",
        "value": "{{$guid}}",
        "description": "Optional client-generated key that makes the request safe to retry\n(1–100 characters `[A-Za-z0-9_.:-]`; malformed → `400 idempotency_key_invalid`).\nScoped to the authenticated account. Two modes (see *Idempotency*):\n\n- **Stored-response mode** (spot orders/cancellations, Convert cancellation,\n  deposit creation, webhook endpoint and sub-account creation): kept 24 h; same\n  key + same request → the stored response is replayed with\n  `Idempotent-Replayed: true`; same key + different request → `409\n  idempotency_key_reused`; first request still running → `409\n  idempotency_request_in_progress`. Only 2xx/4xx responses (except 429) are\n  stored, so retrying a 5xx with the same key is safe.\n- **Permanent mode** (Convert execution and crypto withdrawals): the key must be\n  8–100 characters (shorter → `400 bad_request`); a retry returns the same\n  conversion (`replayed: true`) or withdrawal (`duplicate: true`) with\n  `Idempotent-Replayed: true`, without expiry; same key with different data →\n  `409 idempotency_conflict`; concurrent retry → `409 idempotency_request_in_progress`."
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/webhooks/endpoints",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "webhooks",
        "endpoints"
       ],
       "query": []
      },
      "description": "Create a webhook endpoint\n\nRegisters an HTTPS endpoint for the chosen events (`\"*\"` = every available event).\nThe URL must use `https`, port 443 or 8443, and a public hostname (checked against\ninternal/reserved addresses). Up to 10 endpoints per account (25 for partners).\nPartners can set `include_customers: true` to also receive sub-account events.\nThe signing `secret` (`whsec_…`) is returned **once**.",
      "body": {
       "mode": "raw",
       "raw": "{\"url\":\"https://hooks.example.com/arandixbit\",\"events\":[\"deposit.credited\",\"withdrawal.completed\",\"withdrawal.failed\"],\"description\":\"production listener\"}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Get a webhook endpoint",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/webhooks/endpoints/{{id}}",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "webhooks",
        "endpoints",
        "{{id}}"
       ],
       "query": []
      },
      "description": "Get a webhook endpoint\n\nOne of your webhook endpoints."
     }
    },
    {
     "name": "Update a webhook endpoint",
     "request": {
      "method": "PATCH",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/webhooks/endpoints/{{id}}",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "webhooks",
        "endpoints",
        "{{id}}"
       ],
       "query": []
      },
      "description": "Update a webhook endpoint\n\nChanges the URL, events, description, `include_customers` or `active`.\nRe-activating (`active: true`) resets the failure counter. The URL is validated\nagain (format and anti-SSRF DNS check) only when it changes.",
      "body": {
       "mode": "raw",
       "raw": "{\"active\":true,\"events\":[\"deposit.credited\",\"deposit.reversed\",\"withdrawal.completed\",\"withdrawal.failed\"]}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Delete a webhook endpoint",
     "request": {
      "method": "DELETE",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/webhooks/endpoints/{{id}}",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "webhooks",
        "endpoints",
        "{{id}}"
       ],
       "query": []
      },
      "description": "Delete a webhook endpoint\n\nDeletes the endpoint. Its pending deliveries are marked `failed`."
     }
    },
    {
     "name": "Rotate the signing secret",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/webhooks/endpoints/{{id}}/rotate-secret",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "webhooks",
        "endpoints",
        "{{id}}",
        "rotate-secret"
       ],
       "query": []
      },
      "description": "Rotate the signing secret\n\nGenerates a new signing secret, effective immediately for new attempts. The new secret is returned once."
     }
    },
    {
     "name": "Send a test event",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/webhooks/endpoints/{{id}}/test",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "webhooks",
        "endpoints",
        "{{id}}",
        "test"
       ],
       "query": []
      },
      "description": "Send a test event\n\nSends a `webhook.test` event to the endpoint right now and returns the result of the attempt. Limited to 5 tests per minute per account (`429` with `Retry-After`)."
     }
    },
    {
     "name": "List deliveries of an endpoint",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/webhooks/endpoints/{{id}}/deliveries",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "webhooks",
        "endpoints",
        "{{id}}",
        "deliveries"
       ],
       "query": [
        {
         "key": "status",
         "value": "pending",
         "disabled": true,
         "description": "Only deliveries in this status."
        },
        {
         "key": "limit",
         "value": "50",
         "disabled": true,
         "description": "Maximum deliveries (default 50, maximum 200)."
        }
       ]
      },
      "description": "List deliveries of an endpoint\n\nDelivery log of the endpoint, newest first, with the last attempt result."
     }
    },
    {
     "name": "List attempts of a delivery",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/webhooks/deliveries/{{id}}/attempts",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "webhooks",
        "deliveries",
        "{{id}}",
        "attempts"
       ],
       "query": []
      },
      "description": "List attempts of a delivery\n\nEvery attempt of one delivery: HTTP status, latency, stable `error_code` and the truncated response."
     }
    },
    {
     "name": "Resend a delivery",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/webhooks/deliveries/{{id}}/resend",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "webhooks",
        "deliveries",
        "{{id}}",
        "resend"
       ],
       "query": []
      },
      "description": "Resend a delivery\n\nQueues a delivered or failed delivery again with the same event id (`X-ARX-Event-Id`), so your de-duplication still applies."
     }
    }
   ]
  },
  {
   "name": "Keys",
   "description": "API key management. Interactive session only — keys cannot manage keys.",
   "item": [
    {
     "name": "List API keys",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "Authorization",
        "value": "Bearer {{access_token}}"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/me/api-keys",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "me",
        "api-keys"
       ],
       "query": [
        {
         "key": "customer_id",
         "value": "3f6c2a1e-8d4b-4c1a-9f2e-7b5d0c9a1e42",
         "disabled": true,
         "description": "Only keys restricted to this sub-account (partners)."
        }
       ]
      },
      "description": "List API keys\n\nLists the active API keys of the logged-in user (secrets are never returned),\ntogether with the account limits and the scopes that can be granted.\nUse `customer_id` to list only the keys restricted to one of your sub-accounts."
     }
    },
    {
     "name": "Create an API key",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "Authorization",
        "value": "Bearer {{access_token}}"
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/me/api-keys",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "me",
        "api-keys"
       ],
       "query": []
      },
      "description": "Create an API key\n\nCreates an API key. Requires an interactive session (never an API key), 2FA\nenabled on the account, the current `password` and a TOTP `totp_code`. Staff\naccounts cannot create keys. A security email is sent to the account owner.\n\n- Without `scopes` the key gets `account.read` only.\n- `wallet.withdraw` / `partner.wallet.withdraw` require `ip_whitelist`.\n- Keys without `ip_whitelist` expire after 90 days; with it they do not expire.\n- Partners can pass `customer_id` to create a key **restricted to one of their\n  sub-accounts** (customer scopes only, up to 5 per sub-account).\n\nThe `secret` is returned **once**. Sign requests as described in\n*Authentication & request signing*.",
      "body": {
       "mode": "raw",
       "raw": "{\"note\":\"market-maker bot\",\"scopes\":[\"account.read\",\"spot.read\",\"spot.trade\"],\"ip_whitelist\":[\"203.0.113.7\",\"2001:db8::1\"],\"password\":\"correct horse battery staple\",\"totp_code\":\"123456\"}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Update an API key",
     "request": {
      "method": "PATCH",
      "header": [
       {
        "key": "Authorization",
        "value": "Bearer {{access_token}}"
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/me/api-keys/{{id}}",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "me",
        "api-keys",
        "{{id}}"
       ],
       "query": []
      },
      "description": "Update an API key\n\nChanges the note, IP allow-list or scopes of a key. Changing the IP list or\n**adding** a scope requires `password` + `totp_code`; removing scopes or changing\nthe note does not. A key with a withdrawal scope must keep an IP allow-list.\nAdding IPs removes the expiry; removing all IPs sets a 90-day expiry.\nExpired keys cannot be edited (`409 api_key_expired`).",
      "body": {
       "mode": "raw",
       "raw": "{\"note\":\"market-maker bot (read only)\",\"scopes\":[\"account.read\",\"spot.read\"]}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Revoke an API key",
     "request": {
      "method": "DELETE",
      "header": [
       {
        "key": "Authorization",
        "value": "Bearer {{access_token}}"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/me/api-keys/{{id}}",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "me",
        "api-keys",
        "{{id}}"
       ],
       "query": []
      },
      "description": "Revoke an API key\n\nRevokes the key immediately. Requests signed with it fail from this moment on."
     }
    },
    {
     "name": "Renew an API key",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "Authorization",
        "value": "Bearer {{access_token}}"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/me/api-keys/{{id}}/renew",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "me",
        "api-keys",
        "{{id}}",
        "renew"
       ],
       "query": []
      },
      "description": "Renew an API key\n\nExtends a key without IP allow-list by 90 days. Renewal opens 5 days before\nexpiry (`409 api_key_renew_too_early` with `details.renewable_from` before that).\nKeys with an IP allow-list never expire (`409 api_key_no_expiry`); expired keys\ncannot be renewed (`409 api_key_expired`)."
     }
    }
   ]
  },
  {
   "name": "Partner",
   "description": "B2B / white-label API for approved partners: create and operate customer sub-accounts (`partner.*`).",
   "item": [
    {
     "name": "Get partner profile",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/me",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "me"
       ],
       "query": []
      },
      "description": "Get partner profile\n\nPartner id, the partner scopes and the partner webhook events. Returns `403 partner_required` when the account is not an approved partner."
     }
    },
    {
     "name": "List sub-accounts",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers"
       ],
       "query": [
        {
         "key": "cursor",
         "value": "",
         "disabled": true,
         "description": "Opaque `next_cursor` from the previous page. Send the same filters as the first request."
        },
        {
         "key": "limit",
         "value": "50",
         "disabled": true,
         "description": "Page size (default 50, maximum 200)."
        }
       ]
      },
      "description": "List sub-accounts\n\nYour sub-accounts, newest first, paginated by cursor."
     }
    },
    {
     "name": "Create a sub-account",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Idempotency-Key",
        "value": "{{$guid}}",
        "description": "Optional client-generated key that makes the request safe to retry\n(1–100 characters `[A-Za-z0-9_.:-]`; malformed → `400 idempotency_key_invalid`).\nScoped to the authenticated account. Two modes (see *Idempotency*):\n\n- **Stored-response mode** (spot orders/cancellations, Convert cancellation,\n  deposit creation, webhook endpoint and sub-account creation): kept 24 h; same\n  key + same request → the stored response is replayed with\n  `Idempotent-Replayed: true`; same key + different request → `409\n  idempotency_key_reused`; first request still running → `409\n  idempotency_request_in_progress`. Only 2xx/4xx responses (except 429) are\n  stored, so retrying a 5xx with the same key is safe.\n- **Permanent mode** (Convert execution and crypto withdrawals): the key must be\n  8–100 characters (shorter → `400 bad_request`); a retry returns the same\n  conversion (`replayed: true`) or withdrawal (`duplicate: true`) with\n  `Idempotent-Replayed: true`, without expiry; same key with different data →\n  `409 idempotency_conflict`; concurrent retry → `409 idempotency_request_in_progress`."
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers"
       ],
       "query": []
      },
      "description": "Create a sub-account\n\nCreates an end-customer sub-account linked to your partner account. The email must\nbe new (an existing account is never linked). `external_ref` is your own reference,\nunique per partner. Blocked jurisdictions return `451 jurisdiction_blocked`;\nduplicated email or reference returns `409 customer_exists`.\n\nThe customer then completes KYC with Sumsub (see `POST\n/v1/partner/customers/{cid}/kyc/token`); partners can never approve KYC.",
      "body": {
       "mode": "raw",
       "raw": "{\"email\":\"customer.one@example.com\",\"full_name\":\"Ana Example\",\"country\":\"BR\",\"external_ref\":\"crm-10042\"}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Get a sub-account",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}"
       ],
       "query": []
      },
      "description": "Get a sub-account\n\nOne of your sub-accounts."
     }
    },
    {
     "name": "Get sub-account KYC status",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/kyc",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "kyc"
       ],
       "query": []
      },
      "description": "Get sub-account KYC status\n\nKYC status of the sub-account (verification by Sumsub). Read only."
     }
    },
    {
     "name": "Create a KYC SDK token",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/kyc/token",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "kyc",
        "token"
       ],
       "query": []
      },
      "description": "Create a KYC SDK token\n\nIssues a Sumsub WebSDK access token so the end customer can complete KYC in your interface. Valid for `ttl_seconds`. The partner never approves KYC. Already approved → `409 kyc_already_approved`."
     }
    },
    {
     "name": "Check whether a sub-account can be closed",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/close",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "close"
       ],
       "query": []
      },
      "description": "Check whether a sub-account can be closed\n\nChecklist before closing: `can_close` is true only when the sub-account is active, every balance\n(all currencies and wallets, including held amounts) is zero and nothing is open — spot orders,\nP2P orders, withdrawals in progress, deposits or payments under review. `blockers` lists what\nis still open. `closure` is the latest closure request, if any."
     }
    },
    {
     "name": "Close a sub-account",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Idempotency-Key",
        "value": "{{$guid}}",
        "description": "Optional client-generated key that makes the request safe to retry\n(1–100 characters `[A-Za-z0-9_.:-]`; malformed → `400 idempotency_key_invalid`).\nScoped to the authenticated account. Two modes (see *Idempotency*):\n\n- **Stored-response mode** (spot orders/cancellations, Convert cancellation,\n  deposit creation, webhook endpoint and sub-account creation): kept 24 h; same\n  key + same request → the stored response is replayed with\n  `Idempotent-Replayed: true`; same key + different request → `409\n  idempotency_key_reused`; first request still running → `409\n  idempotency_request_in_progress`. Only 2xx/4xx responses (except 429) are\n  stored, so retrying a 5xx with the same key is safe.\n- **Permanent mode** (Convert execution and crypto withdrawals): the key must be\n  8–100 characters (shorter → `400 bad_request`); a retry returns the same\n  conversion (`replayed: true`) or withdrawal (`duplicate: true`) with\n  `Idempotent-Replayed: true`, without expiry; same key with different data →\n  `409 idempotency_conflict`; concurrent retry → `409 idempotency_request_in_progress`."
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/close",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "close"
       ],
       "query": []
      },
      "description": "Close a sub-account\n\nUnlinks an end customer: the sub-account moves to `pending_closure` immediately — every\noperation on it stops (`403`), and its sessions and keys are revoked. The closure is then\ncompleted by our team (data required by law — KYC/AML, ledger, audit — is retained for 5 years).\n\nOnly possible with a **zero balance in every currency** and nothing open; otherwise `409` with\nthe reason (`open_orders`, `open_p2p`, `pending_withdrawals`, `pending_payments` or\n`balance_not_zero`). Withdraw or convert the funds first. Calling it again returns `200` with\n`already_requested: true`. Optional `reason` (up to 500 characters).",
      "body": {
       "mode": "raw",
       "raw": "{\"reason\":\"customer left the platform\"}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Get sub-account balances",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/balances",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "balances"
       ],
       "query": []
      },
      "description": "Get sub-account balances\n\nSame behavior as the corresponding account endpoint, applied to the sub-account `{cid}`. See `GET /v1/balances`."
     }
    },
    {
     "name": "List sub-account history",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/history",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "history"
       ],
       "query": [
        {
         "key": "type",
         "value": "deposit",
         "disabled": true,
         "description": "Only items of this type. Omit for all types."
        },
        {
         "key": "from",
         "value": "2026-10-01T00:00:00Z",
         "disabled": true,
         "description": "Start of the period (inclusive), RFC 3339 or epoch milliseconds. Default: `to` minus 90 days."
        },
        {
         "key": "to",
         "value": "2026-10-01T00:00:00Z",
         "disabled": true,
         "description": "End of the period (exclusive), RFC 3339 or epoch milliseconds. Default: now. Maximum window: 366 days."
        },
        {
         "key": "cursor",
         "value": "",
         "disabled": true,
         "description": "Opaque `next_cursor` from the previous page. Send the same filters as the first request."
        },
        {
         "key": "limit",
         "value": "50",
         "disabled": true,
         "description": "Page size (default 50, maximum 200)."
        }
       ]
      },
      "description": "List sub-account history\n\nSame behavior as the corresponding account endpoint, applied to the sub-account `{cid}`. Same parameters and response as `GET /v1/history`."
     }
    },
    {
     "name": "Get a sub-account fixed deposit address",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/fixed-address?coin=USDT&network=Tron(TRC20)",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "fixed-address"
       ],
       "query": [
        {
         "key": "coin",
         "value": "USDT",
         "disabled": false,
         "description": "Coin."
        },
        {
         "key": "network",
         "value": "Tron(TRC20)",
         "disabled": false,
         "description": "Network name from `mexc_deposit.networks`."
        }
       ]
      },
      "description": "Get a sub-account fixed deposit address\n\nSame behavior as the corresponding account endpoint, applied to the sub-account `{cid}`. Each sub-account has its own fixed address per coin and network; deposits to it are credited to the sub-account automatically (`deposit.credited` webhook to the partner). Requires approved KYC of the sub-account. See `GET /v1/crypto/fixed-address`."
     }
    },
    {
     "name": "List sub-account deposits to fixed addresses",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/fixed-deposits",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "fixed-deposits"
       ],
       "query": []
      },
      "description": "List sub-account deposits to fixed addresses\n\nSame behavior as the corresponding account endpoint, applied to the sub-account `{cid}`. See `GET /v1/crypto/fixed-deposits`."
     }
    },
    {
     "name": "Get a unique deposit address for one invoice",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Idempotency-Key",
        "value": "{{$guid}}",
        "description": "Optional client-generated key that makes the request safe to retry\n(1–100 characters `[A-Za-z0-9_.:-]`; malformed → `400 idempotency_key_invalid`).\nScoped to the authenticated account. Two modes (see *Idempotency*):\n\n- **Stored-response mode** (spot orders/cancellations, Convert cancellation,\n  deposit creation, webhook endpoint and sub-account creation): kept 24 h; same\n  key + same request → the stored response is replayed with\n  `Idempotent-Replayed: true`; same key + different request → `409\n  idempotency_key_reused`; first request still running → `409\n  idempotency_request_in_progress`. Only 2xx/4xx responses (except 429) are\n  stored, so retrying a 5xx with the same key is safe.\n- **Permanent mode** (Convert execution and crypto withdrawals): the key must be\n  8–100 characters (shorter → `400 bad_request`); a retry returns the same\n  conversion (`replayed: true`) or withdrawal (`duplicate: true`) with\n  `Idempotent-Replayed: true`, without expiry; same key with different data →\n  `409 idempotency_conflict`; concurrent retry → `409 idempotency_request_in_progress`."
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/invoice-addresses",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "invoice-addresses"
       ],
       "query": []
      },
      "description": "Get a unique deposit address for one invoice\n\nReturns a deposit address used only by this invoice (`reference`) of the sub-account\n`{cid}`. Accepted: `BTC`/`BTC`, `USDT`/`TRC20`, and `USDT` or `USDC` on `BEP20`,\n`ERC20`, `POLYGON` and `SOL` (other names of the same network, such as `Solana`,\n`Ethereum(ERC20)` or `Polygon(MATIC)`, are accepted and answered with the short name).\nNative coins (ETH, BNB, POL, SOL) are not accepted. Any other combination answers\n`422 network_not_supported`. The address is new: never shared with\nanother reference nor with the sub-account fixed address.\n\nIdempotent per partner, sub-account and `reference`: repeating the call returns the\nsame address with `200` (`201` when it is created). The same `reference` with another\ncoin or network answers `409 reference_conflict`.\n\nDeposits to the address are credited to the sub-account automatically, under the same\nrules as the fixed address (minimum deposit, fees, compliance, `deposit.credited`\nwebhook with `invoice_address_id` and `reference`), and show up in\n`GET .../invoice-addresses/{id}` and `GET .../fixed-deposits`.\n\n**Coin check:** show the `coin` and the `network` of the response to the payer next to\nthe address. Another coin sent there on another network is lost or held for manual\nreview. Another supported coin of the SAME network (for example `USDC` sent to a\n`USDT`/`SOL` address) IS credited automatically, in the coin that arrived: always\ncompare `coin` and amount of each deposit (and of the `deposit.credited` webhook) with\nthe invoice before marking it paid.\n\nRequires scope `partner.wallet.write` (restricted key: `wallet.write`) and approved KYC\nof the sub-account. `429` when the partner or the sub-account passed the daily limit\nof new invoice addresses on that network; `503 crypto_deposit_unavailable` while the\nnetwork cannot issue addresses or the feature is switched off.",
      "body": {
       "mode": "raw",
       "raw": "{\"coin\":\"USDT\",\"network\":\"TRC20\",\"reference\":\"inv-2026-000123\"}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Get an invoice address and its deposits",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/invoice-addresses/{{id}}",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "invoice-addresses",
        "{{id}}"
       ],
       "query": []
      },
      "description": "Get an invoice address and its deposits\n\nThe invoice address of the sub-account `{cid}` and the deposits seen on it (newest first, up to 100). Addresses of any other sub-account return `404`."
     }
    },
    {
     "name": "List sub-account USDT deposit orders",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/usdt/deposits",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "usdt",
        "deposits"
       ],
       "query": []
      },
      "description": "List sub-account USDT deposit orders\n\nSame behavior as the corresponding account endpoint, applied to the sub-account `{cid}`. See `GET /v1/usdt/deposits`."
     }
    },
    {
     "name": "Create a sub-account USDT deposit order",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Idempotency-Key",
        "value": "{{$guid}}",
        "description": "Optional client-generated key that makes the request safe to retry\n(1–100 characters `[A-Za-z0-9_.:-]`; malformed → `400 idempotency_key_invalid`).\nScoped to the authenticated account. Two modes (see *Idempotency*):\n\n- **Stored-response mode** (spot orders/cancellations, Convert cancellation,\n  deposit creation, webhook endpoint and sub-account creation): kept 24 h; same\n  key + same request → the stored response is replayed with\n  `Idempotent-Replayed: true`; same key + different request → `409\n  idempotency_key_reused`; first request still running → `409\n  idempotency_request_in_progress`. Only 2xx/4xx responses (except 429) are\n  stored, so retrying a 5xx with the same key is safe.\n- **Permanent mode** (Convert execution and crypto withdrawals): the key must be\n  8–100 characters (shorter → `400 bad_request`); a retry returns the same\n  conversion (`replayed: true`) or withdrawal (`duplicate: true`) with\n  `Idempotent-Replayed: true`, without expiry; same key with different data →\n  `409 idempotency_conflict`; concurrent retry → `409 idempotency_request_in_progress`."
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/usdt/deposits",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "usdt",
        "deposits"
       ],
       "query": []
      },
      "description": "Create a sub-account USDT deposit order\n\n**Paused** (`503 usdt_deposit_paused`): use the sub-account fixed address (`GET /v1/partner/customers/{cid}/fixed-address`). Same behavior as the corresponding account endpoint, applied to the sub-account `{cid}`. Requires approved KYC of the sub-account; the credit goes to the sub-account. See `POST /v1/usdt/deposits`.",
      "body": {
       "mode": "raw",
       "raw": "{\"asset\":\"USDTTRC20\",\"amount\":250000000}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "List sub-account withdrawals",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/withdrawals",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "withdrawals"
       ],
       "query": [
        {
         "key": "rail",
         "value": "dubaicash",
         "disabled": true,
         "description": "Only withdrawals of this rail."
        }
       ]
      },
      "description": "List sub-account withdrawals\n\nSame behavior as the corresponding account endpoint, applied to the sub-account `{cid}`. See `GET /v1/rails/withdrawals`."
     }
    },
    {
     "name": "List sub-account whitelist",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/whitelist",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "whitelist"
       ],
       "query": []
      },
      "description": "List sub-account whitelist\n\nSame behavior as the corresponding account endpoint, applied to the sub-account `{cid}`. See `GET /v1/crypto/whitelist`."
     }
    },
    {
     "name": "Whitelist an address for a sub-account",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/whitelist",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "whitelist"
       ],
       "query": []
      },
      "description": "Whitelist an address for a sub-account\n\nAdds a withdrawal address to the sub-account whitelist. The security cooldown starts\nnow; withdrawals to the address are accepted only after it elapses. Audited with the\npartner as actor. API key with IP allow-list only.",
      "body": {
       "mode": "raw",
       "raw": "{\"network\":\"dc:USDTTRC20\",\"address\":\"TXexampleAddressDoNotUse000000000000\",\"label\":\"customer payout\"}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Quote a sub-account crypto withdrawal",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/mexc/withdrawals/quote?coin=USDT&network=TRX&amount=500000000",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "mexc",
        "withdrawals",
        "quote"
       ],
       "query": [
        {
         "key": "coin",
         "value": "USDT",
         "disabled": false,
         "description": "Coin, e.g. `USDT`."
        },
        {
         "key": "network",
         "value": "TRX",
         "disabled": false,
         "description": "Network code from `mexc_withdraw.networks`."
        },
        {
         "key": "amount",
         "value": "500000000",
         "disabled": false,
         "description": "Amount the destination receives, minor units."
        }
       ]
      },
      "description": "Quote a sub-account crypto withdrawal\n\nSame behavior as the corresponding account endpoint, applied to the sub-account `{cid}`. Fee, minimum/maximum and memo support, USDT included. See `GET /v1/mexc/withdrawals/quote`."
     }
    },
    {
     "name": "Withdraw crypto from a sub-account",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Idempotency-Key",
        "value": "{{$guid}}",
        "description": "Optional client-generated key that makes the request safe to retry\n(1–100 characters `[A-Za-z0-9_.:-]`; malformed → `400 idempotency_key_invalid`).\nScoped to the authenticated account. Two modes (see *Idempotency*):\n\n- **Stored-response mode** (spot orders/cancellations, Convert cancellation,\n  deposit creation, webhook endpoint and sub-account creation): kept 24 h; same\n  key + same request → the stored response is replayed with\n  `Idempotent-Replayed: true`; same key + different request → `409\n  idempotency_key_reused`; first request still running → `409\n  idempotency_request_in_progress`. Only 2xx/4xx responses (except 429) are\n  stored, so retrying a 5xx with the same key is safe.\n- **Permanent mode** (Convert execution and crypto withdrawals): the key must be\n  8–100 characters (shorter → `400 bad_request`); a retry returns the same\n  conversion (`replayed: true`) or withdrawal (`duplicate: true`) with\n  `Idempotent-Replayed: true`, without expiry; same key with different data →\n  `409 idempotency_conflict`; concurrent retry → `409 idempotency_request_in_progress`."
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/mexc/withdrawals",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "mexc",
        "withdrawals"
       ],
       "query": []
      },
      "description": "Withdraw crypto from a sub-account\n\nWithdraws a crypto asset (USDT included) from the sub-account through the Pool ArandixBit. API key with\nIP allow-list only, and only to an address on the **sub-account** whitelist\n(`mexc:<COIN>:<network>`) whose cooldown has elapsed. The sub-account's KYC, security\nlock, plan limits and fees apply. Same body and responses as `POST /v1/mexc/withdrawals`\n(without `code`).\n\n**Rules**\n\n- With an API key (`wallet.withdraw`, IP allow-list required): only to an address on\n  the account whitelist whose security cooldown has elapsed\n  (`422 address_not_whitelisted` / `422 address_cooldown`); no `code` needed.\n- With a session: `code` (TOTP) is required when 2FA is enabled.\n- Approved KYC, the 24 h security lock after a password/2FA change\n  (`403 security_lock`), plan limits (per transaction, daily, monthly) and the network\n  fee apply. Above the automatic threshold the withdrawal waits for four-eyes review\n  (`auto: false`), with the amount reserved.\n- `amount` is what the destination receives; `debit = amount + fee`.\n- Fee protection: send `quote_id` (from the quote endpoint) and/or `max_fee` (minor\n  units). If the current fee is higher, nothing is debited and the API answers\n  `409 withdraw_fee_changed` with `details.fee`.\n- Idempotency (permanent mode): send `Idempotency-Key` (8–100 characters). A retry\n  returns the **same** withdrawal with `duplicate: true` and the header\n  `Idempotent-Replayed: true`, without time limit; the same key with different data\n  returns `409 idempotency_conflict`; a concurrent retry returns\n  `409 idempotency_request_in_progress`.",
      "body": {
       "mode": "raw",
       "raw": "{\"coin\":\"USDT\",\"network\":\"TRX\",\"amount\":500000000,\"to_address\":\"TXexampleAddressDoNotUse000000000000\",\"max_fee\":2000000}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Withdraw USDT from a sub-account",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Idempotency-Key",
        "value": "{{$guid}}",
        "description": "Optional client-generated key that makes the request safe to retry\n(1–100 characters `[A-Za-z0-9_.:-]`; malformed → `400 idempotency_key_invalid`).\nScoped to the authenticated account. Two modes (see *Idempotency*):\n\n- **Stored-response mode** (spot orders/cancellations, Convert cancellation,\n  deposit creation, webhook endpoint and sub-account creation): kept 24 h; same\n  key + same request → the stored response is replayed with\n  `Idempotent-Replayed: true`; same key + different request → `409\n  idempotency_key_reused`; first request still running → `409\n  idempotency_request_in_progress`. Only 2xx/4xx responses (except 429) are\n  stored, so retrying a 5xx with the same key is safe.\n- **Permanent mode** (Convert execution and crypto withdrawals): the key must be\n  8–100 characters (shorter → `400 bad_request`); a retry returns the same\n  conversion (`replayed: true`) or withdrawal (`duplicate: true`) with\n  `Idempotent-Replayed: true`, without expiry; same key with different data →\n  `409 idempotency_conflict`; concurrent retry → `409 idempotency_request_in_progress`."
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/usdt/withdrawals",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "usdt",
        "withdrawals"
       ],
       "query": []
      },
      "description": "Withdraw USDT from a sub-account\n\n**Moved** (`503 usdt_withdraw_moved`): use `POST /v1/partner/customers/{cid}/mexc/withdrawals`\nwith `coin: \"USDT\"`.\n\nWithdraws USDT from the sub-account. API key with IP allow-list only, and only to an\naddress on the **sub-account** whitelist whose cooldown has elapsed. The sub-account's\nKYC, security lock, plan limits and fees apply. Same body and responses as\n`POST /v1/usdt/withdrawals` (without `code`).\n\n**Rules**\n\n- With an API key (`wallet.withdraw`, IP allow-list required): only to an address on\n  the account whitelist whose security cooldown has elapsed\n  (`422 address_not_whitelisted` / `422 address_cooldown`); no `code` needed.\n- With a session: `code` (TOTP) is required when 2FA is enabled.\n- Approved KYC, the 24 h security lock after a password/2FA change\n  (`403 security_lock`), plan limits (per transaction, daily, monthly) and the network\n  fee apply. Above the automatic threshold the withdrawal waits for four-eyes review\n  (`auto: false`), with the amount reserved.\n- `amount` is what the destination receives; `debit = amount + fee`.\n- Fee protection: send `quote_id` (from the quote endpoint) and/or `max_fee` (minor\n  units). If the current fee is higher, nothing is debited and the API answers\n  `409 withdraw_fee_changed` with `details.fee`.\n- Idempotency (permanent mode): send `Idempotency-Key` (8–100 characters). A retry\n  returns the **same** withdrawal with `duplicate: true` and the header\n  `Idempotent-Replayed: true`, without time limit; the same key with different data\n  returns `409 idempotency_conflict`; a concurrent retry returns\n  `409 idempotency_request_in_progress`.",
      "body": {
       "mode": "raw",
       "raw": "{\"asset\":\"USDTTRC20\",\"amount\":500000000,\"to_address\":\"TXexampleAddressDoNotUse000000000000\",\"max_fee\":2000000}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Quote a conversion for a sub-account",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/convert/quote",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "convert",
        "quote"
       ],
       "query": []
      },
      "description": "Quote a conversion for a sub-account\n\nSame behavior as the corresponding account endpoint, applied to the sub-account `{cid}`. Uses the sub-account's plan, fees and limits. See `POST /v1/convert/quote`.",
      "body": {
       "mode": "raw",
       "raw": "{\"from\":\"USDT\",\"to\":\"BTC\",\"amount\":100000000}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Execute a conversion for a sub-account",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Idempotency-Key",
        "value": "{{$guid}}",
        "description": "Optional client-generated key that makes the request safe to retry\n(1–100 characters `[A-Za-z0-9_.:-]`; malformed → `400 idempotency_key_invalid`).\nScoped to the authenticated account. Two modes (see *Idempotency*):\n\n- **Stored-response mode** (spot orders/cancellations, Convert cancellation,\n  deposit creation, webhook endpoint and sub-account creation): kept 24 h; same\n  key + same request → the stored response is replayed with\n  `Idempotent-Replayed: true`; same key + different request → `409\n  idempotency_key_reused`; first request still running → `409\n  idempotency_request_in_progress`. Only 2xx/4xx responses (except 429) are\n  stored, so retrying a 5xx with the same key is safe.\n- **Permanent mode** (Convert execution and crypto withdrawals): the key must be\n  8–100 characters (shorter → `400 bad_request`); a retry returns the same\n  conversion (`replayed: true`) or withdrawal (`duplicate: true`) with\n  `Idempotent-Replayed: true`, without expiry; same key with different data →\n  `409 idempotency_conflict`; concurrent retry → `409 idempotency_request_in_progress`."
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/convert",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "convert"
       ],
       "query": []
      },
      "description": "Execute a conversion for a sub-account\n\nSame behavior as the corresponding account endpoint, applied to the sub-account `{cid}`. Uses the sub-account's KYC, limits and fiat approval flow; idempotency in permanent mode (8–100 characters, `409 idempotency_conflict` on mismatch). See `POST /v1/convert`.",
      "body": {
       "mode": "raw",
       "raw": "{\"from\":\"USDT\",\"to\":\"BTC\",\"amount\":100000000,\"quote_id\":\"00000000-0000-4000-8000-000000000651\"}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "List sub-account conversions",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/convert/orders",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "convert",
        "orders"
       ],
       "query": []
      },
      "description": "List sub-account conversions\n\nSame behavior as the corresponding account endpoint, applied to the sub-account `{cid}`. See `GET /v1/convert/orders`."
     }
    },
    {
     "name": "Get sub-account statement",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/statement",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "statement"
       ],
       "query": [
        {
         "key": "type",
         "value": "deposit",
         "disabled": true,
         "description": "Only lines of this type. `fee` returns only the fee lines."
        },
        {
         "key": "currency",
         "value": "BRL",
         "disabled": true,
         "description": "Only lines in this currency (2–10 upper-case letters/digits)."
        },
        {
         "key": "from",
         "value": "2026-10-01T00:00:00Z",
         "disabled": true,
         "description": "Start of the period (inclusive), RFC 3339 or epoch milliseconds. Default: `to` minus 90 days."
        },
        {
         "key": "to",
         "value": "2026-10-01T00:00:00Z",
         "disabled": true,
         "description": "End of the period (exclusive), RFC 3339 or epoch milliseconds. Default: now. Maximum window: 366 days."
        },
        {
         "key": "cursor",
         "value": "",
         "disabled": true,
         "description": "Opaque `next_cursor` from the previous page. Send the same filters as the first request."
        },
        {
         "key": "limit",
         "value": "",
         "disabled": true,
         "description": "Number of ledger entries per page. JSON: default 100, maximum 500. CSV: default 1000, maximum 5000. An entry with a fee produces two lines."
        },
        {
         "key": "format",
         "value": "json",
         "disabled": true,
         "description": "`json` (default) or `csv`."
        }
       ]
      },
      "description": "Get sub-account statement\n\nSame behavior as the corresponding account endpoint, applied to the sub-account `{cid}`. Same filters and formats (JSON/CSV) as `GET /v1/statement`."
     }
    },
    {
     "name": "List sub-account PIX deposits",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/pix/deposits",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "pix",
        "deposits"
       ],
       "query": []
      },
      "description": "List sub-account PIX deposits\n\nSame behavior as the corresponding account endpoint, applied to the sub-account `{cid}`. See `GET /v1/pix/deposits`."
     }
    },
    {
     "name": "Create a sub-account PIX charge",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Idempotency-Key",
        "value": "{{$guid}}",
        "description": "Optional client-generated key that makes the request safe to retry\n(1–100 characters `[A-Za-z0-9_.:-]`; malformed → `400 idempotency_key_invalid`).\nScoped to the authenticated account. Two modes (see *Idempotency*):\n\n- **Stored-response mode** (spot orders/cancellations, Convert cancellation,\n  deposit creation, webhook endpoint and sub-account creation): kept 24 h; same\n  key + same request → the stored response is replayed with\n  `Idempotent-Replayed: true`; same key + different request → `409\n  idempotency_key_reused`; first request still running → `409\n  idempotency_request_in_progress`. Only 2xx/4xx responses (except 429) are\n  stored, so retrying a 5xx with the same key is safe.\n- **Permanent mode** (Convert execution and crypto withdrawals): the key must be\n  8–100 characters (shorter → `400 bad_request`); a retry returns the same\n  conversion (`replayed: true`) or withdrawal (`duplicate: true`) with\n  `Idempotent-Replayed: true`, without expiry; same key with different data →\n  `409 idempotency_conflict`; concurrent retry → `409 idempotency_request_in_progress`."
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/pix/deposits",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "pix",
        "deposits"
       ],
       "query": []
      },
      "description": "Create a sub-account PIX charge\n\nSame behavior as the corresponding account endpoint, applied to the sub-account `{cid}`. The sub-account's own approved KYC is required and the credit goes only to the sub-account.\n\nCreates a BRL deposit by PIX. The credit goes **only** to the account in context. The `auto`\nfield of the response tells which flow applies, and the flow can change without notice, so\nalways branch on it:\n\n**Automatic charge (`auto: true`):** `qr.payload` is a PIX copy-and-paste code for the exact\namount. Pay it before `expires_at`; the credit is automatic after the provider confirms the\npayment (`deposit.credited`). An identical open charge can be returned again (`reused: true`).\nNo service fee, unless the account is in a fee group.\n\n**Manual flow:** send `accept_manual: true` if you can show the receiving account and send the\npayment proof. The response then carries `instructions_fields`, `reference` and, when available,\n`qr`; send the proof with `POST /v1/partner/customers/{cid}/pix/deposits/{id}/proof`. Without the\nfield, while the manual flow is active this endpoint answers `503 pix_provider_unavailable` and\ncreates nothing.\n\nThe sandbox has no PIX provider, so it never returns an automatic charge. A fee group can replace\nthe minimum and the fee and can restrict PIX to certain hours.\n\nSame rules in both flows:\n\n- approved KYC of the receiving account; the charge carries the name/document of that\n  account's KYC profile;\n- from R$ 10,00 (`422 pix_amount_out_of_range` on an automatic charge,\n  `422 deposit_below_minimum` on a manual one) to R$ 500.000,00 per PIX\n  (`422 pix_amount_out_of_range`);\n- valid for up to 24 hours; a manual deposit without proof expires after that;\n- up to 5 open charges (`429 pix_too_many_open`);\n- R$ 5.000.000,00 per account per day (`409 pix_daily_limit_exceeded`);\n- plan deposit limit (`409 deposit_limit_exceeded`; `details`: `window`, `level`,\n  `plan`, `limit_usd_minor`, `used_usd_minor`, `remaining_usd_minor`,\n  `amount_usd_minor`).\n\nA PIX returned by the payer's bank or a MED claim produces `deposit.reversed`.",
      "body": {
       "mode": "raw",
       "raw": "{\"amount\":50000}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Create a sub-account fiat deposit",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Idempotency-Key",
        "value": "{{$guid}}",
        "description": "Optional client-generated key that makes the request safe to retry\n(1–100 characters `[A-Za-z0-9_.:-]`; malformed → `400 idempotency_key_invalid`).\nScoped to the authenticated account. Two modes (see *Idempotency*):\n\n- **Stored-response mode** (spot orders/cancellations, Convert cancellation,\n  deposit creation, webhook endpoint and sub-account creation): kept 24 h; same\n  key + same request → the stored response is replayed with\n  `Idempotent-Replayed: true`; same key + different request → `409\n  idempotency_key_reused`; first request still running → `409\n  idempotency_request_in_progress`. Only 2xx/4xx responses (except 429) are\n  stored, so retrying a 5xx with the same key is safe.\n- **Permanent mode** (Convert execution and crypto withdrawals): the key must be\n  8–100 characters (shorter → `400 bad_request`); a retry returns the same\n  conversion (`replayed: true`) or withdrawal (`duplicate: true`) with\n  `Idempotent-Replayed: true`, without expiry; same key with different data →\n  `409 idempotency_conflict`; concurrent retry → `409 idempotency_request_in_progress`."
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/fiat/deposits",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "fiat",
        "deposits"
       ],
       "query": []
      },
      "description": "Create a sub-account fiat deposit\n\nFiat deposit for the sub-account (the credit goes only to the sub-account). Same\nbody and rules as `POST /v1/fiat/deposits` in the app; without `currency`/`method`\nit creates a BRL PIX charge (same response as `POST\n/v1/partner/customers/{cid}/pix/deposits`). Other currencies/methods return the\nreceiving-account instructions, or `422 method_unavailable`.\n\nWhile the manual PIX flow is active, a BRL PIX request answers `503 pix_provider_unavailable`\nand creates nothing, unless it sends `accept_manual: true`.",
      "body": {
       "mode": "raw",
       "raw": "{\"currency\":\"BRL\",\"method\":\"pix\",\"amount\":50000}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Send the proof of a sub-account manual PIX deposit",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/pix/deposits/{{id}}/proof",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "pix",
        "deposits",
        "{{id}}",
        "proof"
       ],
       "query": []
      },
      "description": "Send the proof of a sub-account manual PIX deposit\n\nSame behavior as `POST /v1/pix/deposits/{id}/proof`, applied to the sub-account `{cid}`. Sign the exact bytes of the multipart body."
     }
    },
    {
     "name": "Get a sub-account PIX deposit",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/pix/deposits/{{id}}",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "pix",
        "deposits",
        "{{id}}"
       ],
       "query": []
      },
      "description": "Get a sub-account PIX deposit\n\nSame behavior as the corresponding account endpoint, applied to the sub-account `{cid}`. Deposits of any other account return `404`. See `GET /v1/pix/deposits/{id}`."
     }
    },
    {
     "name": "Get the partner's own balances",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/balances",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "balances"
       ],
       "query": []
      },
      "description": "Get the partner's own balances\n\nBalances of the partner account itself, not of its sub-accounts. One row per currency and wallet."
     }
    },
    {
     "name": "List partner Earn products",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/earn/products",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "earn",
        "products"
       ],
       "query": []
      },
      "description": "List partner Earn products\n\nActive products with APY, term, minimum, early-exit penalty and refund delay.\n`min_claim_usd` is the minimum yield withdrawal in US dollars."
     }
    },
    {
     "name": "List a sub-account Earn positions",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/earn/positions",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "earn",
        "positions"
       ],
       "query": [
        {
         "key": "cursor",
         "value": "",
         "disabled": true,
         "description": "Value of next_cursor."
        },
        {
         "key": "limit",
         "value": "50",
         "disabled": true
        }
       ]
      },
      "description": "List a sub-account Earn positions\n\nNewest first. Paginated with `cursor` and `next_cursor`."
     }
    },
    {
     "name": "Open an Earn position",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Idempotency-Key",
        "value": "{{$guid}}",
        "description": "Optional client-generated key that makes the request safe to retry\n(1–100 characters `[A-Za-z0-9_.:-]`; malformed → `400 idempotency_key_invalid`).\nScoped to the authenticated account. Two modes (see *Idempotency*):\n\n- **Stored-response mode** (spot orders/cancellations, Convert cancellation,\n  deposit creation, webhook endpoint and sub-account creation): kept 24 h; same\n  key + same request → the stored response is replayed with\n  `Idempotent-Replayed: true`; same key + different request → `409\n  idempotency_key_reused`; first request still running → `409\n  idempotency_request_in_progress`. Only 2xx/4xx responses (except 429) are\n  stored, so retrying a 5xx with the same key is safe.\n- **Permanent mode** (Convert execution and crypto withdrawals): the key must be\n  8–100 characters (shorter → `400 bad_request`); a retry returns the same\n  conversion (`replayed: true`) or withdrawal (`duplicate: true`) with\n  `Idempotent-Replayed: true`, without expiry; same key with different data →\n  `409 idempotency_conflict`; concurrent retry → `409 idempotency_request_in_progress`."
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/earn/positions",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "earn",
        "positions"
       ],
       "query": []
      },
      "description": "Open an Earn position\n\nMoves the capital from the sub-account Funding wallet into the position, atomically. The APY is frozen at this moment.\n**`Idempotency-Key` is required** and is permanent per sub-account: the same key with the same data returns the\noriginal position (`200`, `replayed: true`); with other data, `409 idempotency_conflict`.\nErrors: `earn_below_minimum`, `earn_product_unavailable`, `insufficient_funds` (422), `kyc_required` (403), `idempotency_key_required` (400).",
      "body": {
       "mode": "raw",
       "raw": "{\"product_id\":\"vault-usdt-90\",\"amount\":1000000000}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Get an Earn position",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/earn/positions/{{id}}",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "earn",
        "positions",
        "{{id}}"
       ],
       "query": []
      },
      "description": "Get an Earn position\n\n`404` if the position is not from this sub-account."
     }
    },
    {
     "name": "Preview an early exit",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/earn/positions/{{id}}/cancel-preview",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "earn",
        "positions",
        "{{id}}",
        "cancel-preview"
       ],
       "query": []
      },
      "description": "Preview an early exit\n\nWhat an exit would cost now. Moves no money."
     }
    },
    {
     "name": "Exit a position early",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Idempotency-Key",
        "value": "{{$guid}}",
        "description": "Optional client-generated key that makes the request safe to retry\n(1–100 characters `[A-Za-z0-9_.:-]`; malformed → `400 idempotency_key_invalid`).\nScoped to the authenticated account. Two modes (see *Idempotency*):\n\n- **Stored-response mode** (spot orders/cancellations, Convert cancellation,\n  deposit creation, webhook endpoint and sub-account creation): kept 24 h; same\n  key + same request → the stored response is replayed with\n  `Idempotent-Replayed: true`; same key + different request → `409\n  idempotency_key_reused`; first request still running → `409\n  idempotency_request_in_progress`. Only 2xx/4xx responses (except 429) are\n  stored, so retrying a 5xx with the same key is safe.\n- **Permanent mode** (Convert execution and crypto withdrawals): the key must be\n  8–100 characters (shorter → `400 bad_request`); a retry returns the same\n  conversion (`replayed: true`) or withdrawal (`duplicate: true`) with\n  `Idempotent-Replayed: true`, without expiry; same key with different data →\n  `409 idempotency_conflict`; concurrent retry → `409 idempotency_request_in_progress`."
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/earn/positions/{{id}}/cancel",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "earn",
        "positions",
        "{{id}}",
        "cancel"
       ],
       "query": []
      },
      "description": "Exit a position early\n\nCharges the penalty now (none on ETH staking), forfeits the yield not yet released and schedules the refund after\n`refund_business_days` (Monday to Friday). Yield already released is paid with the refund. Repeating returns the same\nstate (`replayed: true`) with no new movement. Errors: `earn_not_active`, `earn_matured` (409)."
     }
    },
    {
     "name": "Withdraw released yield",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Idempotency-Key",
        "value": "{{$guid}}",
        "description": "Optional client-generated key that makes the request safe to retry\n(1–100 characters `[A-Za-z0-9_.:-]`; malformed → `400 idempotency_key_invalid`).\nScoped to the authenticated account. Two modes (see *Idempotency*):\n\n- **Stored-response mode** (spot orders/cancellations, Convert cancellation,\n  deposit creation, webhook endpoint and sub-account creation): kept 24 h; same\n  key + same request → the stored response is replayed with\n  `Idempotent-Replayed: true`; same key + different request → `409\n  idempotency_key_reused`; first request still running → `409\n  idempotency_request_in_progress`. Only 2xx/4xx responses (except 429) are\n  stored, so retrying a 5xx with the same key is safe.\n- **Permanent mode** (Convert execution and crypto withdrawals): the key must be\n  8–100 characters (shorter → `400 bad_request`); a retry returns the same\n  conversion (`replayed: true`) or withdrawal (`duplicate: true`) with\n  `Idempotent-Replayed: true`, without expiry; same key with different data →\n  `409 idempotency_conflict`; concurrent retry → `409 idempotency_request_in_progress`."
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/earn/positions/{{id}}/claim",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "earn",
        "positions",
        "{{id}}",
        "claim"
       ],
       "query": []
      },
      "description": "Withdraw released yield\n\nPays all released yield to the Funding wallet, from the equivalent of US$ 100 per position. Send `Idempotency-Key`: repeating\nit returns the same withdrawal (`replayed: true`). Errors: `earn_nothing_to_claim`, `earn_not_active` (409), `earn_below_min_claim` (422),\n`price_unavailable` (503)."
     }
    },
    {
     "name": "Get a sub-account's effective fees",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/fees",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "fees"
       ],
       "query": []
      },
      "description": "Get a sub-account's effective fees\n\nSame behavior as `GET /v1/me/fees`, applied to the sub-account `{cid}`. When the\nsub-account (or its partner) is in a **fee group** (contract pricing), the response\ncarries `fee_group` with the rates that replace the plan's for PIX, Convert, crypto\nand Paraguay payouts. Without a group the response is exactly the plan's."
     }
    },
    {
     "name": "List sub-account PIX withdrawals",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/pix/withdrawals",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "pix",
        "withdrawals"
       ],
       "query": [
        {
         "key": "limit",
         "value": "50",
         "disabled": true
        }
       ]
      },
      "description": "List sub-account PIX withdrawals\n\nBRL PIX withdrawals of the sub-account `{cid}`, newest first (`limit`, default 50, max 200)."
     }
    },
    {
     "name": "Withdraw BRL by PIX from a sub-account",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Idempotency-Key",
        "value": "{{$guid}}",
        "description": "Optional client-generated key that makes the request safe to retry\n(1–100 characters `[A-Za-z0-9_.:-]`; malformed → `400 idempotency_key_invalid`).\nScoped to the authenticated account. Two modes (see *Idempotency*):\n\n- **Stored-response mode** (spot orders/cancellations, Convert cancellation,\n  deposit creation, webhook endpoint and sub-account creation): kept 24 h; same\n  key + same request → the stored response is replayed with\n  `Idempotent-Replayed: true`; same key + different request → `409\n  idempotency_key_reused`; first request still running → `409\n  idempotency_request_in_progress`. Only 2xx/4xx responses (except 429) are\n  stored, so retrying a 5xx with the same key is safe.\n- **Permanent mode** (Convert execution and crypto withdrawals): the key must be\n  8–100 characters (shorter → `400 bad_request`); a retry returns the same\n  conversion (`replayed: true`) or withdrawal (`duplicate: true`) with\n  `Idempotent-Replayed: true`, without expiry; same key with different data →\n  `409 idempotency_conflict`; concurrent retry → `409 idempotency_request_in_progress`."
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/pix/withdrawals",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "pix",
        "withdrawals"
       ],
       "query": []
      },
      "description": "Withdraw BRL by PIX from a sub-account\n\nSame flow as `POST /v1/fiat/withdrawals` (`currency: BRL`, `method: pix`), applied to\nthe sub-account `{cid}`. API key with IP allow-list only.\n\n**Rules**\n\n- The PIX destination must belong to the end customer: `holder_name` and\n  `holder_document` default to the sub-account's KYC profile (name and CPF/CNPJ) and\n  are checked against it (`422 pix_holder_not_owner`). A `cpf`/`cnpj` key must be the\n  holder's own document. `pix_key_type` (`cpf`, `cnpj`, `email`, `mobile`, `evp`) is\n  inferred from the key when omitted.\n- Approved KYC of the sub-account (`403 kyc_required`), 24 h security lock\n  (`403 security_lock`), balance (`422 insufficient_funds`), per-PIX ceiling and daily\n  ceiling in BRL (`422 pix_amount_out_of_range`, `409 pix_daily_limit_exceeded`).\n- Fee: taken out of the amount — the balance is debited `amount` and the customer\n  receives `net = amount − fee`. Fee-group accounts pay the group percentage and must\n  respect the group minimum (`422 withdrawal_below_minimum`) and PIX hours window\n  (`422 pix_outside_hours`, `details.start`/`end`/`tz`/`days`); other accounts follow\n  the plan (and the platform business-hours rule, `422 outside_business_hours`).\n- The withdrawal is created `pending` (amount reserved) and paid by our team with\n  four-eyes review; status changes arrive as `withdrawal.sent` →\n  `withdrawal.completed` (or `withdrawal.failed`), and a PIX returned by the receiving\n  bank as `withdrawal.returned`.\n- Idempotency (stored-response mode): send `Idempotency-Key`; a retry within 24 h\n  returns the **same** withdrawal with `Idempotent-Replayed: true`.",
      "body": {
       "mode": "raw",
       "raw": "{\"amount\":50000,\"pix_key\":\"529.982.247-25\"}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Get a sub-account PIX withdrawal",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/pix/withdrawals/{{id}}",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "pix",
        "withdrawals",
        "{{id}}"
       ],
       "query": []
      },
      "description": "Get a sub-account PIX withdrawal\n\nOne BRL PIX withdrawal of the sub-account `{cid}`. Withdrawals of any other account return `404`."
     }
    },
    {
     "name": "Quote a Paraguay payout for a sub-account",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/py/payouts/quote?pay=USDT&deliver=USD&amount=",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "py",
        "payouts",
        "quote"
       ],
       "query": [
        {
         "key": "pay",
         "value": "USDT",
         "disabled": false
        },
        {
         "key": "deliver",
         "value": "USD",
         "disabled": false
        },
        {
         "key": "method",
         "value": "transfer",
         "disabled": true
        },
        {
         "key": "amount",
         "value": "",
         "disabled": false,
         "description": "Decimal amount paid"
        }
       ]
      },
      "description": "Quote a Paraguay payout for a sub-account\n\nPrice of a \"Receive in Paraguay\" payout for the sub-account `{cid}` (same as\n`GET /v1/fiat/payout/quote`): the customer pays with a balance in `pay` and receives\n`deliver` by bank transfer (SIPAP — USD or PYG only) or cash (Ciudad del Este — USD,\nPYG or BRL). `amount` is a **decimal** in `pay` units (e.g. `100.5`). Values in the\nresponse are decimals too; the fee follows the sub-account's fee group when there is\none (`fee_bps`). Informational: the rate is locked at creation.\n\nPYG uses the live exchange-house price: the selling price when you pay with PYG and the buying\nprice when PYG is delivered."
     }
    },
    {
     "name": "List sub-account Paraguay payouts",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/py/payouts",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "py",
        "payouts"
       ],
       "query": []
      },
      "description": "List sub-account Paraguay payouts\n\nThe 50 most recent \"Receive in Paraguay\" payouts of the sub-account `{cid}`, newest first."
     }
    },
    {
     "name": "Create a Paraguay payout from a sub-account",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Idempotency-Key",
        "value": "{{$guid}}",
        "description": "Optional client-generated key that makes the request safe to retry\n(1–100 characters `[A-Za-z0-9_.:-]`; malformed → `400 idempotency_key_invalid`).\nScoped to the authenticated account. Two modes (see *Idempotency*):\n\n- **Stored-response mode** (spot orders/cancellations, Convert cancellation,\n  deposit creation, webhook endpoint and sub-account creation): kept 24 h; same\n  key + same request → the stored response is replayed with\n  `Idempotent-Replayed: true`; same key + different request → `409\n  idempotency_key_reused`; first request still running → `409\n  idempotency_request_in_progress`. Only 2xx/4xx responses (except 429) are\n  stored, so retrying a 5xx with the same key is safe.\n- **Permanent mode** (Convert execution and crypto withdrawals): the key must be\n  8–100 characters (shorter → `400 bad_request`); a retry returns the same\n  conversion (`replayed: true`) or withdrawal (`duplicate: true`) with\n  `Idempotent-Replayed: true`, without expiry; same key with different data →\n  `409 idempotency_conflict`; concurrent retry → `409 idempotency_request_in_progress`."
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/py/payouts",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "py",
        "payouts"
       ],
       "query": []
      },
      "description": "Create a Paraguay payout from a sub-account\n\nSame flow as `POST /v1/fiat/payout`, applied to the sub-account `{cid}`. API key with\nIP allow-list only. The source amount is reserved now and the exchange rate is\n**locked**; our team pays it (bank transfer or cash) and the status changes arrive as\n`withdrawal.sent` + `withdrawal.completed` (`rail: py_payout`) or `withdrawal.failed`\n(rejected/cancelled — the reserve goes back to the balance).\n\n**Rules**\n\n- `method: transfer` (SIPAP) delivers only `USD` or `PYG` and needs `destination`\n  (bank, account/alias, holder…); `method: cash` delivers `USD`, `PYG` or `BRL` at\n  `cash_location: ciudad_del_este` (`422 delivery_not_allowed`), with a cash minimum\n  of ≈ R$ 1,000 (`422 below_minimum`).\n- Approved KYC of the sub-account (`403 kyc_required`), 24 h security lock,\n  balance in `source_currency` (`422 insufficient_funds`).\n- Fee: 1.5 % transfer / 1.8 % cash, or the fee-group rates (`fee_bps` on the payout);\n  `deliver_amount` is already net of the fee.\n- Idempotency (stored-response mode): send `Idempotency-Key`; a retry within 24 h\n  returns the **same** payout with `Idempotent-Replayed: true`.",
      "body": {
       "mode": "raw",
       "raw": "{\"source_currency\":\"USDT\",\"deliver_currency\":\"PYG\",\"method\":\"transfer\",\"source_amount\":100000000,\"destination\":{\"bank\":\"Banco Example\",\"account\":\"0000000\",\"holder\":\"Maria Final\",\"document\":\"1234567\"}}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Get a sub-account Paraguay payout",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/py/payouts/{{id}}",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "py",
        "payouts",
        "{{id}}"
       ],
       "query": []
      },
      "description": "Get a sub-account Paraguay payout\n\nOne payout of the sub-account `{cid}`. Payouts of any other account return `404`."
     }
    }
   ]
  },
  {
   "name": "Sandbox",
   "description": "Sandbox-only self-service: test KYC/KYB approval, B2B activation and fictitious balances. Every operation answers `404` in production.",
   "item": [
    {
     "name": "Get sandbox status",
     "request": {
      "method": "GET",
      "header": [],
      "url": {
       "raw": "{{base_url}}/v1/sandbox/status",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "sandbox",
        "status"
       ],
       "query": []
      },
      "description": "Get sandbox status\n\nConfirms you are calling the sandbox and lists the daily fictitious-balance limits per currency (whole units, rolling 24 h per account). Answers `404` in production."
     }
    },
    {
     "name": "Approve your own KYC (sandbox)",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "Authorization",
        "value": "Bearer {{access_token}}"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/sandbox/kyc/approve",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "sandbox",
        "kyc",
        "approve"
       ],
       "query": []
      },
      "description": "Approve your own KYC (sandbox)\n\nSandbox only. Approves the KYC of the logged-in account — or the KYB when the profile type is `business` — so you can test the full flow. Session only (not API keys). Answers `404` in production, where KYC is verified by Sumsub."
     }
    },
    {
     "name": "Activate your B2B partner account (sandbox)",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "Authorization",
        "value": "Bearer {{access_token}}"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/sandbox/partner/activate",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "sandbox",
        "partner",
        "activate"
       ],
       "query": []
      },
      "description": "Activate your B2B partner account (sandbox)\n\nSandbox only. Turns the logged-in account into a B2B partner with the same eligibility rules as production (active, approved `business` KYB, not a sub-account) → `422 partner_not_eligible` otherwise; already a partner → `409 partner_grant_open`. Session only. Answers `404` in production, where partners are approved by ArandixBit staff."
     }
    },
    {
     "name": "Add fictitious balance (sandbox)",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/sandbox/faucet",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "sandbox",
        "faucet"
       ],
       "query": []
      },
      "description": "Add fictitious balance (sandbox)\n\nSandbox only. Credits a fictitious balance to your own account. Limited per currency over a rolling 24 h window (see `GET /v1/sandbox/status`) → `429 sandbox_faucet_limit`. Answers `404` in production.",
      "body": {
       "mode": "raw",
       "raw": "{\"currency\":\"USDT\",\"amount\":\"100.50\",\"wallet\":\"funding\"}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Approve a sub-account KYC (sandbox)",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/sandbox/kyc/approve",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "sandbox",
        "kyc",
        "approve"
       ],
       "query": []
      },
      "description": "Approve a sub-account KYC (sandbox)\n\nSandbox only. Approves the KYC of your sub-account `{cid}` for testing (another partner's sub-account → `404`). Answers `404` in production, where the end customer verifies with Sumsub."
     }
    },
    {
     "name": "Add fictitious balance to a sub-account (sandbox)",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/partner/customers/{{cid}}/sandbox/faucet",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "partner",
        "customers",
        "{{cid}}",
        "sandbox",
        "faucet"
       ],
       "query": []
      },
      "description": "Add fictitious balance to a sub-account (sandbox)\n\nSandbox only. Same as `POST /v1/sandbox/faucet`, credited to your sub-account `{cid}` (limits are per sub-account). Answers `404` in production.",
      "body": {
       "mode": "raw",
       "raw": "{\"currency\":\"USDT\",\"amount\":\"100.50\",\"wallet\":\"funding\"}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "List your test webhook receivers (sandbox)",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/sandbox/webhook-inboxes",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "sandbox",
        "webhook-inboxes"
       ],
       "query": []
      },
      "description": "List your test webhook receivers (sandbox)\n\nSandbox only. Answers `404` in production."
     }
    },
    {
     "name": "Create a test webhook receiver (sandbox)",
     "request": {
      "method": "POST",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/sandbox/webhook-inboxes",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "sandbox",
        "webhook-inboxes"
       ],
       "query": []
      },
      "description": "Create a test webhook receiver (sandbox)\n\nSandbox only. Creates a receiver with a public URL (secret token) that stores every request it gets. Up to 5 per account → `409`. Answers `404` in production."
     }
    },
    {
     "name": "Set the receiver response status (sandbox)",
     "request": {
      "method": "PATCH",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       },
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/sandbox/webhook-inboxes/{{id}}",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "sandbox",
        "webhook-inboxes",
        "{{id}}"
       ],
       "query": []
      },
      "description": "Set the receiver response status (sandbox)\n\nSandbox only. Sets the HTTP status the receiver answers with (200–599), for example `503` to exercise webhook retries.",
      "body": {
       "mode": "raw",
       "raw": "{\"respond_status\":503}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Delete a test webhook receiver (sandbox)",
     "request": {
      "method": "DELETE",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/sandbox/webhook-inboxes/{{id}}",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "sandbox",
        "webhook-inboxes",
        "{{id}}"
       ],
       "query": []
      },
      "description": "Delete a test webhook receiver (sandbox)\n\nSandbox only. Deletes the receiver and everything it stored."
     }
    },
    {
     "name": "Read what a test receiver got (sandbox)",
     "request": {
      "method": "GET",
      "header": [
       {
        "key": "X-ARX-APIKEY",
        "value": "{{api_key}}"
       },
       {
        "key": "X-ARX-TIMESTAMP",
        "value": ""
       },
       {
        "key": "X-ARX-SIGNATURE",
        "value": ""
       }
      ],
      "url": {
       "raw": "{{base_url}}/v1/sandbox/webhook-inboxes/{{id}}/requests",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "sandbox",
        "webhook-inboxes",
        "{{id}}",
        "requests"
       ],
       "query": [
        {
         "key": "limit",
         "value": "50",
         "disabled": true
        }
       ]
      },
      "description": "Read what a test receiver got (sandbox)\n\nSandbox only. Latest requests first (up to 200 kept per receiver), exactly as received — header names in lower case, raw body — so you can verify `X-ARX-Signature` (`t=<unix>,v1=hex(HMAC-SHA256(secret, t + \".\" + body))`). Credential headers (`Authorization`, `Cookie`) are never stored. Another account's receiver → `404`."
     }
    },
    {
     "name": "Test receiver endpoint (sandbox)",
     "request": {
      "method": "POST",
      "header": [],
      "url": {
       "raw": "{{base_url}}/v1/sandbox/webhook-inboxes/receive/{{token}}",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "v1",
        "sandbox",
        "webhook-inboxes",
        "receive",
        "{{token}}"
       ],
       "query": []
      },
      "description": "Test receiver endpoint (sandbox)\n\nSandbox only. The public destination behind a receiver `url` — this is what your webhook endpoint points to. Stores the request (body up to 64 KiB) and answers with the receiver `respond_status`. Unknown token → `404`."
     }
    }
   ]
  }
 ]
}
