Create a ramp
POST/ramps
Creates an onramp that buys crypto with fiat, or an offramp that converts the user's stablecoin balance to fiat, through the given provider. The response's redirect_url is the provider page the user completes the ramp on.
An offramp tops any shortfall up from the user's CeFi balance first, which requires completed KYC and enough CeFi PYUSD, and returns a bridge_plan when the user's own cross-chain funds must move first: sign its payloads, submit them to POST /ramps/{id}/bridge/execute, then call POST /ramps/{id}/prepare.
An onramp has nothing to sign, and is subject to provider preconditions: phone verification, accepted provider terms, an active wallet, and amount limits.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 409
- 422
- 500
- 503
Ramp created successfully
Bad request
Unauthorized
Forbidden. On order creation this also covers an asset that is not available to trade from the country the request came from.
Not found
Conflict
Request is well-formed but cannot be processed (e.g. leverage missing or out of range for a perp order)
Internal server error
Service unavailable