Get a quote

curl -X POST https://sandbox.core.linkio.world/api/quotes/generate \
  -H "X-BRIDGE-API-Key: $BRIDGE_API_KEY" \
  -H "API-Version: 2026-10-29-atlas" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "cus_4hT9pL2mQx8VnR3tY7wZ1cB5dE",
    "transaction_type": "onramp",
    "source_amount": "150000",
    "source_currency": "NGN",
    "target_currency": "USDC",
    "payment_method": "bank_transfer",
    "network": "solana"
  }'

curl -X POST https://sandbox.core.linkio.world/api/quotes/generate \
  -H "X-BRIDGE-API-Key: $BRIDGE_API_KEY" \
  -H "API-Version: 2026-10-29-atlas" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "cus_4hT9pL2mQx8VnR3tY7wZ1cB5dE",
    "transaction_type": "offramp",
    "source_amount": "100",
    "source_currency": "USDC",
    "target_currency": "GHS",
    "payout_method": "momo",
    "network": "base"
  }'

{
  "status": "success",
  "message": "Quote generated",
  "quote": {
    "id": "qte_9xLp3VnR7tY1wZ4cB6dE8fK2mQ",
    "source_amount": "150000",
    "source_currency": "NGN",
    "target_amount": "97.71",
    "target_currency": "USDC",
    "payment_method": "bank_transfer",
    "payout_method": "stablecoin",
    "network": "solana",
    "transaction_type": "onramp",
    "rate": "1535",
    "expires_at": "2026-10-28T10:15:20.000Z"
  }
}

{
  "error": {
    "type": "validation_error",
    "code": "invalid_amount",
    "message": "Invalid amount 1000 NGN: minimum is 15000",
    "request_id": "req_3VnR7tY1wZ4cB6dE8fK2mQ9xLp",
    "status": 422
  }
}

{
  "error": {
    "type": "authorization_error",
    "code": "pair_not_enabled",
    "message": "The USDC/NGN pair is not enabled for this business. Contact support to enable it before creating onramp transactions.",
    "request_id": "req_3VnR7tY1wZ4cB6dE8fK2mQ9xLp",
    "status": 403
  }
}

POST

quotes

generate

curl -X POST https://sandbox.core.linkio.world/api/quotes/generate \
  -H "X-BRIDGE-API-Key: $BRIDGE_API_KEY" \
  -H "API-Version: 2026-10-29-atlas" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "cus_4hT9pL2mQx8VnR3tY7wZ1cB5dE",
    "transaction_type": "onramp",
    "source_amount": "150000",
    "source_currency": "NGN",
    "target_currency": "USDC",
    "payment_method": "bank_transfer",
    "network": "solana"
  }'

curl -X POST https://sandbox.core.linkio.world/api/quotes/generate \
  -H "X-BRIDGE-API-Key: $BRIDGE_API_KEY" \
  -H "API-Version: 2026-10-29-atlas" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "cus_4hT9pL2mQx8VnR3tY7wZ1cB5dE",
    "transaction_type": "offramp",
    "source_amount": "100",
    "source_currency": "USDC",
    "target_currency": "GHS",
    "payout_method": "momo",
    "network": "base"
  }'

{
  "status": "success",
  "message": "Quote generated",
  "quote": {
    "id": "qte_9xLp3VnR7tY1wZ4cB6dE8fK2mQ",
    "source_amount": "150000",
    "source_currency": "NGN",
    "target_amount": "97.71",
    "target_currency": "USDC",
    "payment_method": "bank_transfer",
    "payout_method": "stablecoin",
    "network": "solana",
    "transaction_type": "onramp",
    "rate": "1535",
    "expires_at": "2026-10-28T10:15:20.000Z"
  }
}

{
  "error": {
    "type": "validation_error",
    "code": "invalid_amount",
    "message": "Invalid amount 1000 NGN: minimum is 15000",
    "request_id": "req_3VnR7tY1wZ4cB6dE8fK2mQ9xLp",
    "status": 422
  }
}

{
  "error": {
    "type": "authorization_error",
    "code": "pair_not_enabled",
    "message": "The USDC/NGN pair is not enabled for this business. Contact support to enable it before creating onramp transactions.",
    "request_id": "req_3VnR7tY1wZ4cB6dE8fK2mQ9xLp",
    "status": 403
  }
}

Requires the Quotes scope (write). See Get a quote for a walkthrough.

Headers

string

default:"2026-10-29-atlas"

required

Your account’s API version.

Body

string

required

The customer, starting with cus_.

string

required

onramp or offramp.

string

required

How much the customer sends, as text, for example "150000". No more decimal places than the currency allows.

string

required

Onramp: a fiat currency, for example NGN or GHS. Offramp: a stablecoin, for example USDC. See Supported currencies.

string

required

Onramp: a stablecoin, for example USDC. Offramp: a fiat currency, for example NGN or GHS. Must differ from source_currency.

string

required

base, polygon, bsc, ethereum, tron, or solana.

string

Onramp only, required there. bank_transfer or momo, depending on the currency (for example bank_transfer for NGN, momo for GHS). Don’t send it on an offramp.

string

Offramp only. bank_transfer or momo, depending on the currency (for example momo is available for GHS). Defaults to bank_transfer. Don’t send it on an onramp.

Response

201 Created

string

success

string

Quote generated

object

Show fields

string

Quote ID, starting with qte_.

string

Amount the customer sends.

string

Currency the customer sends.

string

Amount the customer receives.

string

Currency the customer receives.

string

How the customer pays in. stablecoin on offramps.

string

How the customer is paid. stablecoin on onramps.

string

The blockchain network.

string

onramp or offramp.

string

Fiat per 1 stablecoin.

string

When the price expires (ISO 8601).

string

Sometimes included. A processing fee.

string

Sometimes included. VAT on the fee.

string

Sometimes included. The exact total the customer must send.

Errors

Status	Code	Why
`422`	`validation_failed`	A field is wrong, the currency or method isn’t supported, or the amount has too many decimal places.
`422`	`invalid_amount`	Below the minimum or above the maximum. See Limits.
`403`	`pair_not_enabled`	The pair isn’t turned on for your business.
`404`	`customer_not_found`	No such customer.
`409`	`customer_banned`	The customer is banned.
`503`	`route_temporarily_unavailable`	No partner can price this right now.
`504`	`request_timeout`	A partner took too long.

curl -X POST https://sandbox.core.linkio.world/api/quotes/generate \
  -H "X-BRIDGE-API-Key: $BRIDGE_API_KEY" \
  -H "API-Version: 2026-10-29-atlas" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "cus_4hT9pL2mQx8VnR3tY7wZ1cB5dE",
    "transaction_type": "onramp",
    "source_amount": "150000",
    "source_currency": "NGN",
    "target_currency": "USDC",
    "payment_method": "bank_transfer",
    "network": "solana"
  }'

curl -X POST https://sandbox.core.linkio.world/api/quotes/generate \
  -H "X-BRIDGE-API-Key: $BRIDGE_API_KEY" \
  -H "API-Version: 2026-10-29-atlas" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "cus_4hT9pL2mQx8VnR3tY7wZ1cB5dE",
    "transaction_type": "offramp",
    "source_amount": "100",
    "source_currency": "USDC",
    "target_currency": "GHS",
    "payout_method": "momo",
    "network": "base"
  }'

{
  "status": "success",
  "message": "Quote generated",
  "quote": {
    "id": "qte_9xLp3VnR7tY1wZ4cB6dE8fK2mQ",
    "source_amount": "150000",
    "source_currency": "NGN",
    "target_amount": "97.71",
    "target_currency": "USDC",
    "payment_method": "bank_transfer",
    "payout_method": "stablecoin",
    "network": "solana",
    "transaction_type": "onramp",
    "rate": "1535",
    "expires_at": "2026-10-28T10:15:20.000Z"
  }
}

{
  "error": {
    "type": "validation_error",
    "code": "invalid_amount",
    "message": "Invalid amount 1000 NGN: minimum is 15000",
    "request_id": "req_3VnR7tY1wZ4cB6dE8fK2mQ9xLp",
    "status": 422
  }
}

{
  "error": {
    "type": "authorization_error",
    "code": "pair_not_enabled",
    "message": "The USDC/NGN pair is not enabled for this business. Contact support to enable it before creating onramp transactions.",
    "request_id": "req_3VnR7tY1wZ4cB6dE8fK2mQ9xLp",
    "status": 403
  }
}

Last modified on October 29, 2026

Overview

Customers

Quotes

Payments

Lookups

Headers

Body

Response

Errors

​Headers

​Body

​Response

​Errors

Headers

Body

Response

Errors