POST
/
v1
/
service
/
transfer
/
quote
/
accept
curl --request POST \
  --url https://api.nxos.io/v1/service/transfer/quote/accept \
  --header 'Content-Type: application/json' \
  --data '{
  "quote_id": "<string>",
  "provider": "<string>",
  "value": {
    "asset": "<string>",
    "amount": "<string>"
  },
  "info": {},
  "transaction": {
    "transaction_ref": "<string>",
    "asset_moves": [
      {
        "asset_move_ref": "<string>",
        "source_account": {
          "ref": "<string>",
          "id": "<string>"
        },
        "destination_account": {
          "ref": "<string>",
          "id": "<string>"
        },
        "asset_code": "<string>",
        "amount": "<string>",
        "type": "<string>",
        "categories": [
          "<string>"
        ],
        "metadata": {}
      }
    ],
    "metadata": {}
  }
}'
{
  "transaction_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "transaction_ref": "<string>",
  "asset_moves": [
    {
      "asset_move_ref": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "source_account": {
        "ref": "<string>",
        "id": "<string>"
      },
      "destination_account": {
        "ref": "<string>",
        "id": "<string>"
      },
      "asset_code": "<string>",
      "amount": "<string>",
      "status": "EXPECTED",
      "type": "<string>",
      "decline_type": "<string>",
      "categories": [
        "<string>"
      ],
      "metadata": {},
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "metadata": {},
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Body

application/json
The details for accepting the quote, including the quote ID and payment information.

Request model for accepting a quote and initiating a transfer.

​
quote_id
string
required

The unique identifier of the quote to accept.

​
value
object
required

The value of the transfer (asset and amount).

​
info
object
required

Payment information required for the transfer. For Ebury, this includes beneficiary details like name, address, and bank information. The specific fields required depend on the provider and destination country.

​
transaction
object
required

Transaction details for ledger accounting. This creates the ledger transaction that reflects the transfer.

​
provider
string

The provider to use for the transfer (e.g., "coinsph", "ebury"). Must match the provider used to obtain the quote.

Response

200 - application/json
The ledger transaction created as part of accepting the quote.
​
transaction_id
string
required

The unique internally assigned identifier of the transaction

​
asset_moves
object[]
required

The asset moves for the transaction

​
created_at
string
required

The created at timestamp

​
updated_at
string
required

The updated at timestamp

​
transaction_ref
string

The externally defined reference of the transaction

​
metadata
object

Additional, optional, metadata for the transaction