Add test funds (paper trading only)

POST 
/paper/deposits

Paper-trading environments only. This endpoint is not served in production, where it answers 404. It exists so integrations can be exercised end to end in a sandbox without moving real money.

Mints amount of the DeFi listing asset_id into the caller's paper wallet. When the funds are allocated, the caller's CeFi trading account is set up if it has none and the same amount is allocated to CeFi trading through POST /cefi/allocations, returned in allocation. With allocate unset, only a listing with a CeFi market is allocated; a DeFi-only listing stays in the wallet. allocate: true on a DeFi-only listing answers 400 before anything is minted. The allocation settles in the background exactly like any other; poll GET /cefi/allocations/{id} for its outcome.

If the allocation step fails, the minted funds stay in the wallet unallocated.

Request

Responses

200

Test funds added, and allocated to CeFi trading when allocation is present

400

Bad request

401

Unauthorized

403

Forbidden. On order creation this also covers an asset that is not available to trade from the country the request came from.

404

Not found

409

Conflict

422

Request is well-formed but cannot be processed (e.g. leverage missing or out of range for a perp order)

500

Internal server error

503

Service unavailable