For the complete documentation index, see llms.txt. This page is also available as Markdown.

Get Fees

Use the dryrun parameter to preview the fee calculation without creating an actual payment.

API Host: https://intentapiv4.rozo.ai/functions/v1

Endpoint: POST /payment-api/payments?dryrun=true

Request

curl --location --request POST 'https://intentapiv4.rozo.ai/functions/v1/payment-api/payments?dryrun=true' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "yourAppId",
    "type": "anyAmount",
    "source": {
        "chainId": "8453",
        "tokenSymbol": "USDC",
        "amount": "100.00"
    },
    "destination": {
        "chainId": "1500",
        "receiverAddress": "GDFLZTLVMLR3OVO4VSODYB7SGVIOI2AS652WODBCGBUQAMXXXXXXXXXX",
        "tokenSymbol": "USDC"
    }
}'

Response

Note: The dryrun=true parameter returns fee details without creating a payment record.

Which rail charged the fee

Dry-run and create responses also carry a feeInfo block that names the routing provider the fee belongs to, so you always know whether a quote is priced on Rozo's own rails or on NEAR Intents:

Provider
Rate

rozo

your app tier (public default 0.1%, minimum $0.01)

near

flat 0.3% (minimum $0.01); per-destination minimums still apply (e.g. Solana $0.20, Ethereum $0.10, USDT on Tron $1)

feePercentage is the effective rate: when a minimum fee applies to a small order it shows the real percentage, not the nominal one.

Rate card without a dry run

GET /payment-api/payments/supported returns the schedule-level rate card for both rails together with the supported chain/token matrix:

These numbers are indicative. The binding fee for a specific order is always the dry-run feeInfo.

Errors specific to NEAR-routed quotes

Error code
Meaning

ROUTE_NOT_SUPPORTED_BY_PROVIDER

You asked for provider: "near" on a route it cannot serve.

AMOUNT_TOO_SMALL

Below the route's minimum; the response includes minimumSourceAmount.

NEGATIVE_ROUTE_ECONOMICS

The amount is too small to cover the network cost of this route; send a larger amount.

Last updated