Generate a widget URL (with quote refresh)

Production

https://api.vortexfinance.co

POST

/v1/session/create

You can call this endpoint to get a widget URL where the widget app will keep refreshing the quote with your specified direction, amount, and currencies.

Request

Body Params application/json

Examples

Responses

🟢201Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

cURL

BRL onrampEURO onramp

curl --location --request POST 'https://api.vortexfinance.co/v1/session/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "callbackUrl": "https://www.example.org/",
    "countryCode": "BR",
    "cryptoLocked": "USDC",
    "externalSessionId": "my-session-id",
    "fiat": "BRL",
    "inputAmount": "300",
    "network": "base",
    "paymentMethod": "pix",
    "partnerId": "my-partner-id",
    "rampType": "BUY"
}'

Response Example

{
    "url": "string"
}

Modified at 2026-01-27 10:38:07

Widget parameters

Generating widget URL (for existing quote)