Skip to main content
POST
/
autoramps
/
{autoramp_id}
/
quotes
Attach a quote to an existing autoramp
curl --request POST \
  --url https://api.sandbox.iron.xyz/api/autoramps/{autoramp_id}/quotes \
  --header 'Content-Type: application/json; charset=utf-8' \
  --header 'IDEMPOTENCY-KEY: <idempotency-key>' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "amount_in": {
    "amount": "100.5",
    "currency": {
      "code": "USD",
      "type": "Fiat"
    }
  },
  "amount_out": {
    "amount": "100.5",
    "currency": {
      "code": "USD",
      "type": "Fiat"
    }
  },
  "autoramp_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "destination_currency": {
    "blockchain": "Solana",
    "token": "USDC"
  },
  "fee": {
    "banking_fee": {
      "amount": "100.5",
      "currency": {
        "code": "USD",
        "type": "Fiat"
      }
    },
    "iron_fee": {
      "amount": "100.5",
      "currency": {
        "code": "USD",
        "type": "Fiat"
      }
    },
    "network_fee": {
      "amount": "100.5",
      "currency": {
        "code": "USD",
        "type": "Fiat"
      }
    },
    "network_fees": [
      {
        "amount": "100.5",
        "currency": {
          "code": "USD",
          "type": "Fiat"
        }
      }
    ],
    "network_fees_with_settlement": [
      {
        "fee_amount": {
          "amount": "100.5",
          "currency": {
            "code": "USD",
            "type": "Fiat"
          }
        },
        "fee_type": "SepaIn",
        "settlement": "deductedImmediately"
      }
    ],
    "partner_fee": {
      "amount": "100.5",
      "currency": {
        "code": "USD",
        "type": "Fiat"
      }
    },
    "partner_fees": [
      {
        "fee": {
          "amount": "100.5",
          "currency": {
            "code": "USD",
            "type": "Fiat"
          }
        },
        "label": "<string>",
        "settlement": "deductedImmediately"
      }
    ],
    "total_fee": {
      "amount": "100.5",
      "currency": {
        "code": "USD",
        "type": "Fiat"
      }
    },
    "transaction_fee": {
      "amount": "100.5",
      "currency": {
        "code": "USD",
        "type": "Fiat"
      }
    },
    "banking_fee_network": "Sepa",
    "deducted_fee": {
      "amount": "100.5",
      "currency": {
        "code": "USD",
        "type": "Fiat"
      }
    },
    "iron_fee_settlement": "deductedImmediately"
  },
  "fee_settlement": "deductedImmediately",
  "quote_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "rate": "<string>",
  "rate_expiry_policy": "Return",
  "rate_lock_valid_until": "2023-11-07T05:31:56Z",
  "signature": "<string>",
  "source_currency": {
    "blockchain": "Solana",
    "token": "USDC"
  },
  "valid_until": "2023-11-07T05:31:56Z",
  "slippage_tolerance_in_bips": "<string>"
}
'
{
  "batch_payout": true,
  "created_at": "2023-11-07T05:31:56Z",
  "deposit_rails": [
    {
      "address": "10 Downing Street, London, SW1A 2AA, GB",
      "beneficiary_name": "Alan Turing",
      "bic": "COBADEFFXXX",
      "iban": "DE89370400440532013000",
      "name": "Iron Bank",
      "phone": "+44-20-1234-5678"
    }
  ],
  "destination_currency": {
    "blockchain": "Solana",
    "token": "USDC"
  },
  "fee_profile_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "is_third_party": true,
  "kind": "Onramp",
  "quotes": [
    {
      "amount_in": {
        "amount": "100.5",
        "currency": {
          "code": "USD",
          "type": "Fiat"
        }
      },
      "amount_out": {
        "amount": "100.5",
        "currency": {
          "code": "USD",
          "type": "Fiat"
        }
      },
      "fee": {
        "banking_fee": {
          "amount": "100.5",
          "currency": {
            "code": "USD",
            "type": "Fiat"
          }
        },
        "iron_fee": {
          "amount": "100.5",
          "currency": {
            "code": "USD",
            "type": "Fiat"
          }
        },
        "network_fee": {
          "amount": "100.5",
          "currency": {
            "code": "USD",
            "type": "Fiat"
          }
        },
        "network_fees": [
          {
            "amount": "100.5",
            "currency": {
              "code": "USD",
              "type": "Fiat"
            }
          }
        ],
        "network_fees_with_settlement": [
          {
            "fee_amount": {
              "amount": "100.5",
              "currency": {
                "code": "USD",
                "type": "Fiat"
              }
            },
            "fee_type": "SepaIn",
            "settlement": "deductedImmediately"
          }
        ],
        "partner_fee": {
          "amount": "100.5",
          "currency": {
            "code": "USD",
            "type": "Fiat"
          }
        },
        "partner_fees": [
          {
            "fee": {
              "amount": "100.5",
              "currency": {
                "code": "USD",
                "type": "Fiat"
              }
            },
            "label": "<string>",
            "settlement": "deductedImmediately"
          }
        ],
        "total_fee": {
          "amount": "100.5",
          "currency": {
            "code": "USD",
            "type": "Fiat"
          }
        },
        "transaction_fee": {
          "amount": "100.5",
          "currency": {
            "code": "USD",
            "type": "Fiat"
          }
        },
        "banking_fee_network": "Sepa",
        "deducted_fee": {
          "amount": "100.5",
          "currency": {
            "code": "USD",
            "type": "Fiat"
          }
        },
        "iron_fee_settlement": "deductedImmediately"
      },
      "fee_settlement": "deductedImmediately",
      "partner_fee_settlement": "deductedImmediately",
      "quote_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "rate": "<string>",
      "rate_expiry_policy": "Return",
      "rate_lock_valid_until": "2023-11-07T05:31:56Z",
      "valid_until": "2023-11-07T05:31:56Z",
      "slippage_tolerance_in_bips": "<string>"
    }
  ],
  "recipient": {
    "account_identifier": {
      "iban": "DE89370400440532013000",
      "type": "SEPA"
    },
    "address": {
      "city": "London",
      "country": {
        "code": "GB"
      },
      "postal_code": "SW1A 2AA",
      "state": "England",
      "street": "10 Downing Street"
    },
    "bank_address": null,
    "email_address": {
      "email": "john.doe@example.com"
    },
    "is_third_party": false,
    "phone_number": "+49-30-12345678",
    "provider_country": {
      "code": "DE"
    },
    "provider_name": "Iron Bank",
    "recipient": {
      "name": "Aperture Science",
      "type": "Business"
    }
  },
  "source": "Standalone",
  "source_currencies": [
    {
      "blockchain": "Solana",
      "token": "USDC"
    }
  ],
  "status": "Created",
  "additional_partner_fee_in_bips": "<string>",
  "deposit_account": {
    "address": "10 Downing Street, London, SW1A 2AA, GB",
    "beneficiary_name": "Alan Turing",
    "bic": "COBADEFFXXX",
    "iban": "DE89370400440532013000",
    "name": "Iron Bank",
    "phone": "+44-20-1234-5678"
  },
  "external_id": "<string>",
  "fps_payment_reference": "<string>",
  "name": "<string>",
  "payment_reference": "<string>",
  "quote": {
    "amount_in": {
      "amount": "100.5",
      "currency": {
        "code": "USD",
        "type": "Fiat"
      }
    },
    "amount_out": {
      "amount": "100.5",
      "currency": {
        "code": "USD",
        "type": "Fiat"
      }
    },
    "fee": {
      "banking_fee": {
        "amount": "100.5",
        "currency": {
          "code": "USD",
          "type": "Fiat"
        }
      },
      "iron_fee": {
        "amount": "100.5",
        "currency": {
          "code": "USD",
          "type": "Fiat"
        }
      },
      "network_fee": {
        "amount": "100.5",
        "currency": {
          "code": "USD",
          "type": "Fiat"
        }
      },
      "network_fees": [
        {
          "amount": "100.5",
          "currency": {
            "code": "USD",
            "type": "Fiat"
          }
        }
      ],
      "network_fees_with_settlement": [
        {
          "fee_amount": {
            "amount": "100.5",
            "currency": {
              "code": "USD",
              "type": "Fiat"
            }
          },
          "fee_type": "SepaIn",
          "settlement": "deductedImmediately"
        }
      ],
      "partner_fee": {
        "amount": "100.5",
        "currency": {
          "code": "USD",
          "type": "Fiat"
        }
      },
      "partner_fees": [
        {
          "fee": {
            "amount": "100.5",
            "currency": {
              "code": "USD",
              "type": "Fiat"
            }
          },
          "label": "<string>",
          "settlement": "deductedImmediately"
        }
      ],
      "total_fee": {
        "amount": "100.5",
        "currency": {
          "code": "USD",
          "type": "Fiat"
        }
      },
      "transaction_fee": {
        "amount": "100.5",
        "currency": {
          "code": "USD",
          "type": "Fiat"
        }
      },
      "banking_fee_network": "Sepa",
      "deducted_fee": {
        "amount": "100.5",
        "currency": {
          "code": "USD",
          "type": "Fiat"
        }
      },
      "iron_fee_settlement": "deductedImmediately"
    },
    "fee_settlement": "deductedImmediately",
    "partner_fee_settlement": "deductedImmediately",
    "quote_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "rate": "<string>",
    "rate_expiry_policy": "Return",
    "rate_lock_valid_until": "2023-11-07T05:31:56Z",
    "valid_until": "2023-11-07T05:31:56Z",
    "slippage_tolerance_in_bips": "<string>"
  },
  "sepa_payment_reference": "<string>",
  "swift_payment_reference": "<string>",
  "travel_address": "<string>",
  "wire_message": "<string>"
}

Authorizations

​
X-API-Key
string
header
required

API Key

Headers

​
IDEMPOTENCY-KEY
string
required

a UUID ensuring the operation is only processed once

Path Parameters

​
autoramp_id
string<uuid>
required

Body

application/json; charset=utf-8

Signed rate quote for an existing autoramp.

Contains only pricing fields — the autoramp's currencies, recipient, etc. are already known.

Deposits are matched to the newest active quote whose amount_in value and currency equal the deposit. Attaching a quote that overlaps an existing one on those fields supersedes it for new deposits; all of the newer quote's terms apply (rate lock, expiry policy, slippage tolerance, fees).

​
amount_in
Amount · object
required

An amount of money

Example:
{
  "amount": "100.5",
  "currency": { "code": "USD", "type": "Fiat" }
}
​
amount_out
Amount · object
required

An amount of money

Example:
{
  "amount": "100.5",
  "currency": { "code": "USD", "type": "Fiat" }
}
​
autoramp_id
string<uuid>
required

The autoramp this quote is for

​
destination_currency
Crypto · object
required

Currency

Can be either crypto or fiat

Example:
{ "blockchain": "Solana", "token": "USDC" }
​
fee
Fee · object
required

Fee

The fee for a given currency pair

​
fee_settlement
enum<string>
required

Fee Settlement

The settlement type for the fee

Available options:
deductedImmediately,
settledLater
​
quote_id
string<uuid>
required

The id of the quote

​
rate
string<decimal>
required

The rate

​
rate_expiry_policy
enum<string>
required

Rate Expiry Policy

The policy for the rate expiry

Available options:
Return,
Slippage
​
rate_lock_valid_until
string<date-time>
required

The rate lock valid until

​
signature
string
required

The signature

​
source_currency
Crypto · object
required

Currency

Can be either crypto or fiat

Example:
{ "blockchain": "Solana", "token": "USDC" }
​
valid_until
string<date-time>
required

The valid until

​
slippage_tolerance_in_bips
string<decimal>

The slippage tolerance in bips

Response

Attach quote successful

Autoramp

The autoramp response

A Autoramp response

​
batch_payout
boolean
required

Whether payouts for this autoramp are batched daily

​
created_at
string<date-time>
required

The created at timestamp

​
deposit_rails
(IbanDepositInfo · object | AfricanBankTransferDepositInfo · object | PixDepositInfo · object | SpeiDepositInfo · object | MobileMoneyDepositInfo · object | CryptoWallet · object | FpsDepositInfo · object | ChapsDepositInfo · object | ACHDepositInfo · object | WireDepositInfo · object | RtpDepositInfo · object | SwiftDepositInfo · object)[]
required
Example:
{
  "address": "10 Downing Street, London, SW1A 2AA, GB",
  "beneficiary_name": "Alan Turing",
  "bic": "COBADEFFXXX",
  "iban": "DE89370400440532013000",
  "name": "Iron Bank",
  "phone": "+44-20-1234-5678"
}
​
destination_currency
Crypto · object
required

Currency

Can be either crypto or fiat

Example:
{ "blockchain": "Solana", "token": "USDC" }
​
fee_profile_id
string<uuid>
required

The fee profile id used for the autoramp

​
id
string<uuid>
required

The id of the autoramp

​
is_third_party
boolean
required

Is this a third party payment (3pp) autoramp

​
kind
enum<string>
required

Autoramp type

The type (onramp, offramp, swap) of an autoramp

Available options:
Onramp,
Offramp,
Swap,
Mint,
Redeem
​
quotes
AutorampQuote · object[]
required

Active (non-expired) quotes associated with this autoramp. Deposits are matched to the newest active quote with matching amount_in value and currency.

​
recipient
RecipientBankAccount · object
required

Recipient

The recipient of the payment

Example:
{
  "account_identifier": {
    "iban": "DE89370400440532013000",
    "type": "SEPA"
  },
  "address": {
    "city": "London",
    "country": { "code": "GB" },
    "postal_code": "SW1A 2AA",
    "state": "England",
    "street": "10 Downing Street"
  },
  "bank_address": null,
  "email_address": { "email": "john.doe@example.com" },
  "is_third_party": false,
  "phone_number": "+49-30-12345678",
  "provider_country": { "code": "DE" },
  "provider_name": "Iron Bank",
  "recipient": {
    "name": "Aperture Science",
    "type": "Business"
  }
}
​
source
enum<string>
required

Autoramp Source

The source of the autoramp

Available options:
Standalone,
Quote
​
source_currencies
(Crypto · object | Fiat · object)[]
required

The source currencies

Currency

Can be either crypto or fiat

Example:
{ "blockchain": "Solana", "token": "USDC" }
​
status
enum<string>
required
Available options:
Created,
EditPending,
Authorized,
DepositAccountAdded,
Approved,
Rejected,
Cancelled
​
additional_partner_fee_in_bips
string<decimal>

The additional partner fee in bips

​
deposit_account
IbanDepositInfo · object
deprecated

Deprecated, please use the information in the deposit_rails field instead

Example:
{
  "address": "10 Downing Street, London, SW1A 2AA, GB",
  "beneficiary_name": "Alan Turing",
  "bic": "COBADEFFXXX",
  "iban": "DE89370400440532013000",
  "name": "Iron Bank",
  "phone": "+44-20-1234-5678"
}
​
external_id
string

External ID for the autoramp, provided by the partner

​
fps_payment_reference
string

reference message for outgoing FPS transfers

​
name
string

The name of the autoramp

​
payment_reference
string

The payment reference for the autoramp

​
quote
AutorampQuote · object
deprecated

Deprecated: use the quotes field instead. Returns the newest active (non-expired) quote if any.

​
sepa_payment_reference
string

reference message for outgoing SEPA transfers

​
swift_payment_reference
string

reference message for outgoing SWIFT transfers

​
travel_address
string

The travel rule address for compliance

​
wire_message
string

reference message for outgoing wire transfers