Create Order

Create Order

curl --request POST \
  --url https://api-sandbox.stablesea.com/v1/organizations/{organization_id}/orders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "quote_id": "<string>"
}
'

{
  "data": {
    "id": "ord_01k4qn3cxdefkargtccm4ycxsf",
    "quote_id": "qt_01k4qpmvgxfsg9db9mjrtq9tk2",
    "offering_id": "off_01k4qph5ezfsga7fkvbygsqq93",
    "reference_number": "SS-ORD-20240115-001",
    "external_reference_id": null,
    "exchange_rate": "4250.00",
    "effective_exchange_rate": "4250.00",
    "payin": {
      "external_payment_instrument": {
        "id": "mnyacctcm_01k4r01nm4f41tcsws4sr9k8nn",
        "alias": "My Solana Wallet",
        "currency": "USDC",
        "method": "SOLANA_ADDRESS",
        "status": {
          "current_status": "ACTIVE",
          "status_history": [
            {
              "status": "ACTIVE",
              "created_at": "2024-01-15T10:00:00Z"
            }
          ]
        },
        "details": {
          "address": "A1B2C3D4E5F6G7H8I9J0K1L2M3N4O5P6Q7R8S9T0U1V2W3X4Y5Z6"
        },
        "created_at": "2024-01-15T10:00:00Z",
        "updated_at": "2024-01-15T10:00:00Z"
      },
      "total": "1015.00",
      "fee": "15.00",
      "tax": "0.00"
    },
    "payout": {
      "external_payment_instrument": {
        "id": "mnyacctcop_01k4r01nkxf41vpxc3nekphrx8",
        "alias": "My COP Bank Account",
        "currency": "COP",
        "method": "COP_BANK_ACCOUNT",
        "status": {
          "current_status": "ACTIVE",
          "status_history": [
            {
              "status": "ACTIVE",
              "created_at": "2024-01-15T11:00:00Z"
            }
          ]
        },
        "details": {
          "bank_account_number": "1234567890",
          "bank_code": "001",
          "account_holder_first_name": "John",
          "account_holder_last_name": "Doe",
          "legal_entity_name": "Acme Corporation",
          "doc_type": "CC",
          "doc_id": "1234567890",
          "physical_address": "123 Main St, Bogota, Colombia",
          "account_type": "CHECKING"
        },
        "created_at": "2024-01-15T11:00:00Z",
        "updated_at": "2024-01-15T11:00:00Z"
      },
      "total": "4250000.00"
    },
    "status": {
      "current_status": "STEP_1_AWAITING_FUNDING",
      "status_history": [
        {
          "status": "STEP_1_AWAITING_FUNDING",
          "created_at": "2024-01-15T10:00:00Z"
        }
      ]
    },
    "funding_instructions": {
      "currency": "USDC",
      "method": "SOLANA_ADDRESS",
      "details": {
        "address": "B2C3D4E5F6G7H8I9J0K1L2M3N4O5P6Q7R8S9T0U1V2W3X4Y5Z6A1"
      }
    },
    "retry_order_id": null,
    "created_at": "2024-01-15T10:00:00Z",
    "updated_at": "2024-01-15T10:00:00Z"
  }
}

POST

organizations

{organization_id}

orders

Create Order

curl --request POST \
  --url https://api-sandbox.stablesea.com/v1/organizations/{organization_id}/orders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "quote_id": "<string>"
}
'

{
  "data": {
    "id": "ord_01k4qn3cxdefkargtccm4ycxsf",
    "quote_id": "qt_01k4qpmvgxfsg9db9mjrtq9tk2",
    "offering_id": "off_01k4qph5ezfsga7fkvbygsqq93",
    "reference_number": "SS-ORD-20240115-001",
    "external_reference_id": null,
    "exchange_rate": "4250.00",
    "effective_exchange_rate": "4250.00",
    "payin": {
      "external_payment_instrument": {
        "id": "mnyacctcm_01k4r01nm4f41tcsws4sr9k8nn",
        "alias": "My Solana Wallet",
        "currency": "USDC",
        "method": "SOLANA_ADDRESS",
        "status": {
          "current_status": "ACTIVE",
          "status_history": [
            {
              "status": "ACTIVE",
              "created_at": "2024-01-15T10:00:00Z"
            }
          ]
        },
        "details": {
          "address": "A1B2C3D4E5F6G7H8I9J0K1L2M3N4O5P6Q7R8S9T0U1V2W3X4Y5Z6"
        },
        "created_at": "2024-01-15T10:00:00Z",
        "updated_at": "2024-01-15T10:00:00Z"
      },
      "total": "1015.00",
      "fee": "15.00",
      "tax": "0.00"
    },
    "payout": {
      "external_payment_instrument": {
        "id": "mnyacctcop_01k4r01nkxf41vpxc3nekphrx8",
        "alias": "My COP Bank Account",
        "currency": "COP",
        "method": "COP_BANK_ACCOUNT",
        "status": {
          "current_status": "ACTIVE",
          "status_history": [
            {
              "status": "ACTIVE",
              "created_at": "2024-01-15T11:00:00Z"
            }
          ]
        },
        "details": {
          "bank_account_number": "1234567890",
          "bank_code": "001",
          "account_holder_first_name": "John",
          "account_holder_last_name": "Doe",
          "legal_entity_name": "Acme Corporation",
          "doc_type": "CC",
          "doc_id": "1234567890",
          "physical_address": "123 Main St, Bogota, Colombia",
          "account_type": "CHECKING"
        },
        "created_at": "2024-01-15T11:00:00Z",
        "updated_at": "2024-01-15T11:00:00Z"
      },
      "total": "4250000.00"
    },
    "status": {
      "current_status": "STEP_1_AWAITING_FUNDING",
      "status_history": [
        {
          "status": "STEP_1_AWAITING_FUNDING",
          "created_at": "2024-01-15T10:00:00Z"
        }
      ]
    },
    "funding_instructions": {
      "currency": "USDC",
      "method": "SOLANA_ADDRESS",
      "details": {
        "address": "B2C3D4E5F6G7H8I9J0K1L2M3N4O5P6Q7R8S9T0U1V2W3X4Y5Z6A1"
      }
    },
    "retry_order_id": null,
    "created_at": "2024-01-15T10:00:00Z",
    "updated_at": "2024-01-15T10:00:00Z"
  }
}

Creates an order for an organization based on a quote.

Common Headers

Header	Value	Required	Description
`Authorization`	`Bearer <api-key>`	true	Your API key for authentication
`Content-Type`	`application/json`	true	Content type of the request
`Idempotency-Key`	`<unique-uuid>`	true	Unique key to prevent duplicate operations

Path

organization_id

string

required

ID of organization

Body

quote_id

string

required

ID of the quote to create an order from

Response

{
  "data": {
    "id": "ord_01k4qn3cxdefkargtccm4ycxsf",
    "quote_id": "qt_01k4qpmvgxfsg9db9mjrtq9tk2",
    "offering_id": "off_01k4qph5ezfsga7fkvbygsqq93",
    "reference_number": "SS-ORD-20240115-001",
    "external_reference_id": null,
    "exchange_rate": "4250.00",
    "effective_exchange_rate": "4250.00",
    "payin": {
      "external_payment_instrument": {
        "id": "mnyacctcm_01k4r01nm4f41tcsws4sr9k8nn",
        "alias": "My Solana Wallet",
        "currency": "USDC",
        "method": "SOLANA_ADDRESS",
        "status": {
          "current_status": "ACTIVE",
          "status_history": [
            {
              "status": "ACTIVE",
              "created_at": "2024-01-15T10:00:00Z"
            }
          ]
        },
        "details": {
          "address": "A1B2C3D4E5F6G7H8I9J0K1L2M3N4O5P6Q7R8S9T0U1V2W3X4Y5Z6"
        },
        "created_at": "2024-01-15T10:00:00Z",
        "updated_at": "2024-01-15T10:00:00Z"
      },
      "total": "1015.00",
      "fee": "15.00",
      "tax": "0.00"
    },
    "payout": {
      "external_payment_instrument": {
        "id": "mnyacctcop_01k4r01nkxf41vpxc3nekphrx8",
        "alias": "My COP Bank Account",
        "currency": "COP",
        "method": "COP_BANK_ACCOUNT",
        "status": {
          "current_status": "ACTIVE",
          "status_history": [
            {
              "status": "ACTIVE",
              "created_at": "2024-01-15T11:00:00Z"
            }
          ]
        },
        "details": {
          "bank_account_number": "1234567890",
          "bank_code": "001",
          "account_holder_first_name": "John",
          "account_holder_last_name": "Doe",
          "legal_entity_name": "Acme Corporation",
          "doc_type": "CC",
          "doc_id": "1234567890",
          "physical_address": "123 Main St, Bogota, Colombia",
          "account_type": "CHECKING"
        },
        "created_at": "2024-01-15T11:00:00Z",
        "updated_at": "2024-01-15T11:00:00Z"
      },
      "total": "4250000.00"
    },
    "status": {
      "current_status": "STEP_1_AWAITING_FUNDING",
      "status_history": [
        {
          "status": "STEP_1_AWAITING_FUNDING",
          "created_at": "2024-01-15T10:00:00Z"
        }
      ]
    },
    "funding_instructions": {
      "currency": "USDC",
      "method": "SOLANA_ADDRESS",
      "details": {
        "address": "B2C3D4E5F6G7H8I9J0K1L2M3N4O5P6Q7R8S9T0U1V2W3X4Y5Z6A1"
      }
    },
    "retry_order_id": null,
    "created_at": "2024-01-15T10:00:00Z",
    "updated_at": "2024-01-15T10:00:00Z"
  }
}

Authorizations

Authorization

string

header

default:DEFAULT-TOKEN-HERE

required

Use your API key as the bearer token

Headers

Idempotency-Key

string

required

Unique key to prevent duplicate operations

Example:

"550e8400-e29b-41d4-a716-446655440000"

Path Parameters

organization_id

string

required

ID of organization

Example:

"org_01k2cm4r59e5z8k5ggrbbxjcwy"

Body

application/json

Order request

quote_id

string

required

Response

201 - application/json

Order created successfully

data

object

Show child attributes

data.id

string

required

Example:

"mnyacct_01k4r01nm4f41tcsws4sr9k8nn"

data.quote_id

string

required

Example:

"qt_01k4qpmvgxfsg9db9mjrtq9tk2"

data.offering_id

string

required

Example:

"off_01k4qph5ezfsga7fkvbygsqq93"

data.reference_number

string

required

Example:

"SS-ORD-20240115-001"

data.exchange_rate

string<decimal>

required

A string representation of a decimal number

data.effective_exchange_rate

string<decimal>

required

A string representation of a decimal number

data.payin

object

required

Show child attributes

data.payin.external_payment_instrument

object

required

Show child attributes

data.payin.external_payment_instrument.id

string

required

Example:

"mnyacct_01k4r01nm4f41tcsws4sr9k8nn"

data.payin.external_payment_instrument.alias

string

required

Example:

"My Primary Wallet"

data.payin.external_payment_instrument.currency

enum<string>

required

Available options:

USDC,

COP,

...more to come...

data.payin.external_payment_instrument.method

enum<string>

required

Available options:

SOLANA_ADDRESS,

COP_BANK_ACCOUNT,

...more to come...

data.payin.external_payment_instrument.status

object

required

Show child attributes

data.payin.external_payment_instrument.status.current_status

enum<string>

Available options:

ACTIVE,

COMPLIANCE_HOLD,

ARCHIVED

data.payin.external_payment_instrument.status.status_history

object[]

Show child attributes

data.payin.external_payment_instrument.status.status_history.status

enum<string>

Available options:

ACTIVE,

COMPLIANCE_HOLD,

ARCHIVED

data.payin.external_payment_instrument.status.status_history.created_at

string<date-time>

ISO 8601 UTC timestamp (RFC3339)

Example:

"2024-01-15T10:00:00Z"

data.payin.external_payment_instrument.details

SOLANA_ADDRESS · object

required

SOLANA_ADDRESS
COP_BANK_ACCOUNT

Show child attributes

data.payin.external_payment_instrument.details.address

string

required

Example:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

data.payin.external_payment_instrument.created_at

string<date-time>

required

ISO 8601 UTC timestamp (RFC3339)

Example:

"2024-01-15T10:00:00Z"

data.payin.external_payment_instrument.updated_at

string<date-time>

required

ISO 8601 UTC timestamp (RFC3339)

Example:

"2024-01-15T10:00:00Z"

data.payin.total

string<decimal>

required

A string representation of a decimal number

data.payin.fee

string<decimal>

required

A string representation of a decimal number

data.payin.tax

string<decimal>

required

A string representation of a decimal number

data.payout

object

required

Show child attributes

data.payout.external_payment_instrument

object

required

Show child attributes

data.payout.external_payment_instrument.id

string

required

Example:

"mnyacct_01k4r01nm4f41tcsws4sr9k8nn"

data.payout.external_payment_instrument.alias

string

required

Example:

"My Primary Wallet"

data.payout.external_payment_instrument.currency

enum<string>

required

Available options:

USDC,

COP,

...more to come...

data.payout.external_payment_instrument.method

enum<string>

required

Available options:

SOLANA_ADDRESS,

COP_BANK_ACCOUNT,

...more to come...

data.payout.external_payment_instrument.status

object

required

Show child attributes

data.payout.external_payment_instrument.status.current_status

enum<string>

Available options:

ACTIVE,

COMPLIANCE_HOLD,

ARCHIVED

data.payout.external_payment_instrument.status.status_history

object[]

Show child attributes

data.payout.external_payment_instrument.status.status_history.status

enum<string>

Available options:

ACTIVE,

COMPLIANCE_HOLD,

ARCHIVED

data.payout.external_payment_instrument.status.status_history.created_at

string<date-time>

ISO 8601 UTC timestamp (RFC3339)

Example:

"2024-01-15T10:00:00Z"

data.payout.external_payment_instrument.details

SOLANA_ADDRESS · object

required

SOLANA_ADDRESS
COP_BANK_ACCOUNT

Show child attributes

data.payout.external_payment_instrument.details.address

string

required

Example:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

data.payout.external_payment_instrument.created_at

string<date-time>

required

ISO 8601 UTC timestamp (RFC3339)

Example:

"2024-01-15T10:00:00Z"

data.payout.external_payment_instrument.updated_at

string<date-time>

required

ISO 8601 UTC timestamp (RFC3339)

Example:

"2024-01-15T10:00:00Z"

data.payout.total

string<decimal>

required

A string representation of a decimal number

data.status

object

required

Show child attributes

data.status.current_status

enum<string>

required

Available options:

STEP_1_AWAITING_FUNDING,

STEP_2_FILLING_FX,

STEP_3_SETTLING_PAYOUT,

STEP_4_COMPLETED,

FAILED_FUNDING_EXPIRED,

FAILED_DECLINED_BY_LIQ_PROVIDER,

FAILED_REFUND_REQUESTED,

FAILED_REFUND_PROCESSED

data.status.status_history

object[]

required

Show child attributes

data.status.status_history.status

enum<string>

Available options:

STEP_1_AWAITING_FUNDING,

STEP_2_FILLING_FX,

STEP_3_SETTLING_PAYOUT,

STEP_4_COMPLETED,

FAILED_FUNDING_EXPIRED,

FAILED_DECLINED_BY_LIQ_PROVIDER,

FAILED_REFUND_REQUESTED,

FAILED_REFUND_PROCESSED

data.status.status_history.created_at

string<date-time>

ISO 8601 UTC timestamp (RFC3339)

Example:

"2024-01-15T10:00:00Z"

data.funding_instructions

object

required

Show child attributes

data.funding_instructions.currency

enum<string>

required

Available options:

USDC,

...more to come...

Example:

"USDC"

data.funding_instructions.method

enum<string>

required

Available options:

SOLANA_ADDRESS,

COP_BANK_ACCOUNT,

...more to come...

data.funding_instructions.details

SOLANA_ADDRESS · object

required

SOLANA_ADDRESS
COP_BANK_ACCOUNT

Show child attributes

data.funding_instructions.details.address

string

required

Example:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

data.created_at

string<date-time>

required

ISO 8601 UTC timestamp (RFC3339)

Example:

"2024-01-15T10:00:00Z"

data.updated_at

string<date-time>

required

ISO 8601 UTC timestamp (RFC3339)

Example:

"2024-01-15T10:00:00Z"

data.external_reference_id

string

Example:

"ACME-REF-001"

data.retry_order_id

string

Example:

"ord_01k4qn4cxdefkargtccm4ycxth"

Get Quote Get Order

⌘I

Overview

Resources

Liquidity Providers

Organizations

External Payment Instruments

Offerings

Quotes

Orders

API Reference

Common Headers

Path

Body

Response

Authorizations

Headers

Path Parameters

Body

Response

Overview

Resources

Liquidity Providers

Organizations

External Payment Instruments

Offerings

Quotes

Orders

API Reference

​Common Headers

​Path

​Body

​Response

Authorizations

Headers

Path Parameters

Body

Response

Common Headers

Path

Body

Response