Create a new order

curl --request POST \
  --url https://mainnet.anyspend.com/orders \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "swap",
  "recipientAddress": "0x58241893EF1f86C9fBd8109Cd44Ea961fDb474e1",
  "srcChain": 1,
  "dstChain": 8453,
  "srcTokenAddress": "0xA0b86a33E6441E8A91DEF8f5663ACb4C9B4a1234",
  "dstTokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "srcAmount": "1000000",
  "payload": {
    "expectedDstAmount": "990000"
  },
  "metadata": {
    "srcToken": {
      "chainId": 8453,
      "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "symbol": "USDC",
      "name": "USD Coin",
      "decimals": 6,
      "metadata": {
        "logoURI": "https://polygonscan.com/token/images/usdc_32.png"
      }
    },
    "dstToken": {
      "chainId": 8453,
      "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "symbol": "USDC",
      "name": "USD Coin",
      "decimals": 6,
      "metadata": {
        "logoURI": "https://polygonscan.com/token/images/usdc_32.png"
      }
    }
  },
  "partnerId": "<string>",
  "clientReferenceId": "<string>",
  "onramp": {
    "vendor": "coinbase",
    "paymentMethod": "",
    "country": "SG",
    "redirectUrl": "https://www.anyspend.com"
  },
  "creatorAddress": "0x58241893EF1f86C9fBd8109Cd44Ea961fDb474e1"
}
'

{
  "success": true,
  "message": "Created order successfully",
  "data": {
    "id": "5392f7a7-d472-4d6b-9848-bd07117fb82d",
    "recipientAddress": "0xb34facb90a200251318e8841c05102366f2158cf",
    "globalAddress": "0xa640beaa78eeb64bb269f2baf8202b9a7316e123",
    "srcChain": 8453,
    "dstChain": 8453,
    "srcTokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
    "dstTokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
    "srcAmount": "93354000",
    "status": "executed",
    "errorDetails": "<string>",
    "createdAt": 1752505794679,
    "expiredAt": 1752506694679,
    "filledAt": 123,
    "receivedDepositAt": 123,
    "creatorAddress": "0xb34facb90a200251318e8841c05102366f2158cf",
    "partnerId": "<string>",
    "onrampMetadata": {
      "country": "US",
      "vendor": "stripe-web2",
      "paymentMethod": "",
      "redirectUrl": "https://www.anyspend.com",
      "stripeAmountInCents": 9900,
      "ipAddress": "192.168.1.1",
      "fingerprint": {
        "requestId": "fp_req_12345",
        "visitorId": "fp_visitor_67890"
      }
    },
    "oneClickBuyUrl": "<string>",
    "stripePaymentIntentId": "pi_3Rko0sJnoDg53PsP0PDLsHkR",
    "settlement": {
      "actualDstAmount": "990000",
      "relay": {
        "status": "success",
        "metadata": {
          "currencyOut": {
            "amount": "990000"
          }
        }
      }
    },
    "type": "swap",
    "payload": {
      "expectedDstAmount": "990000"
    },
    "metadata": {
      "srcToken": {
        "chainId": 8453,
        "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "symbol": "USDC",
        "name": "USD Coin",
        "decimals": 6,
        "metadata": {
          "logoURI": "https://polygonscan.com/token/images/usdc_32.png"
        }
      },
      "dstToken": {
        "chainId": 8453,
        "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "symbol": "USDC",
        "name": "USD Coin",
        "decimals": 6,
        "metadata": {
          "logoURI": "https://polygonscan.com/token/images/usdc_32.png"
        }
      }
    },
    "clientReferenceId": "<string>",
    "fee": {
      "type": "standard_fee",
      "feeVersion": 1,
      "tokenToCheckBalance": "0xb3b32f9f8827d4634fe7d973fa1034ec9fddb3b3",
      "recipientBalance": "302843673392800000000000",
      "anyspendFeeBps": 80,
      "anyspendWhaleDiscountBps": 5000,
      "anyspendPartnerDiscountBps": 0,
      "finalFeeBps": 40
    }
  },
  "statusCode": 200
}

POST

orders

Create a new order

curl --request POST \
  --url https://mainnet.anyspend.com/orders \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "swap",
  "recipientAddress": "0x58241893EF1f86C9fBd8109Cd44Ea961fDb474e1",
  "srcChain": 1,
  "dstChain": 8453,
  "srcTokenAddress": "0xA0b86a33E6441E8A91DEF8f5663ACb4C9B4a1234",
  "dstTokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "srcAmount": "1000000",
  "payload": {
    "expectedDstAmount": "990000"
  },
  "metadata": {
    "srcToken": {
      "chainId": 8453,
      "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "symbol": "USDC",
      "name": "USD Coin",
      "decimals": 6,
      "metadata": {
        "logoURI": "https://polygonscan.com/token/images/usdc_32.png"
      }
    },
    "dstToken": {
      "chainId": 8453,
      "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "symbol": "USDC",
      "name": "USD Coin",
      "decimals": 6,
      "metadata": {
        "logoURI": "https://polygonscan.com/token/images/usdc_32.png"
      }
    }
  },
  "partnerId": "<string>",
  "clientReferenceId": "<string>",
  "onramp": {
    "vendor": "coinbase",
    "paymentMethod": "",
    "country": "SG",
    "redirectUrl": "https://www.anyspend.com"
  },
  "creatorAddress": "0x58241893EF1f86C9fBd8109Cd44Ea961fDb474e1"
}
'

{
  "success": true,
  "message": "Created order successfully",
  "data": {
    "id": "5392f7a7-d472-4d6b-9848-bd07117fb82d",
    "recipientAddress": "0xb34facb90a200251318e8841c05102366f2158cf",
    "globalAddress": "0xa640beaa78eeb64bb269f2baf8202b9a7316e123",
    "srcChain": 8453,
    "dstChain": 8453,
    "srcTokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
    "dstTokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
    "srcAmount": "93354000",
    "status": "executed",
    "errorDetails": "<string>",
    "createdAt": 1752505794679,
    "expiredAt": 1752506694679,
    "filledAt": 123,
    "receivedDepositAt": 123,
    "creatorAddress": "0xb34facb90a200251318e8841c05102366f2158cf",
    "partnerId": "<string>",
    "onrampMetadata": {
      "country": "US",
      "vendor": "stripe-web2",
      "paymentMethod": "",
      "redirectUrl": "https://www.anyspend.com",
      "stripeAmountInCents": 9900,
      "ipAddress": "192.168.1.1",
      "fingerprint": {
        "requestId": "fp_req_12345",
        "visitorId": "fp_visitor_67890"
      }
    },
    "oneClickBuyUrl": "<string>",
    "stripePaymentIntentId": "pi_3Rko0sJnoDg53PsP0PDLsHkR",
    "settlement": {
      "actualDstAmount": "990000",
      "relay": {
        "status": "success",
        "metadata": {
          "currencyOut": {
            "amount": "990000"
          }
        }
      }
    },
    "type": "swap",
    "payload": {
      "expectedDstAmount": "990000"
    },
    "metadata": {
      "srcToken": {
        "chainId": 8453,
        "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "symbol": "USDC",
        "name": "USD Coin",
        "decimals": 6,
        "metadata": {
          "logoURI": "https://polygonscan.com/token/images/usdc_32.png"
        }
      },
      "dstToken": {
        "chainId": 8453,
        "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "symbol": "USDC",
        "name": "USD Coin",
        "decimals": 6,
        "metadata": {
          "logoURI": "https://polygonscan.com/token/images/usdc_32.png"
        }
      }
    },
    "clientReferenceId": "<string>",
    "fee": {
      "type": "standard_fee",
      "feeVersion": 1,
      "tokenToCheckBalance": "0xb3b32f9f8827d4634fe7d973fa1034ec9fddb3b3",
      "recipientBalance": "302843673392800000000000",
      "anyspendFeeBps": 80,
      "anyspendWhaleDiscountBps": 5000,
      "anyspendPartnerDiscountBps": 0,
      "finalFeeBps": 40
    }
  },
  "statusCode": 200
}

Body

application/json

Swap order request

type

enum<string>

required

Order type

Available options:

swap

recipientAddress

string

required

Address to receive the destination tokens

Example:

"0x58241893EF1f86C9fBd8109Cd44Ea961fDb474e1"

srcChain

number

required

Source chain ID

Example:

1

dstChain

number

required

Destination chain ID

Example:

8453

srcTokenAddress

string

required

Source token contract address

Example:

"0xA0b86a33E6441E8A91DEF8f5663ACb4C9B4a1234"

dstTokenAddress

string

required

Destination token contract address

Example:

"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

srcAmount

string

required

Amount of source tokens to swap

Example:

"1000000"

payload

object

required

Swap-specific payload

Show child attributes

payload.expectedDstAmount

string

required

Expected amount of destination tokens

Example:

"990000"

metadata

object

required

Swap metadata for display purposes

Show child attributes

metadata.srcToken

object

required

Token details

Show child attributes

metadata.srcToken.chainId

number

required

Token chain ID

Example:

8453

metadata.srcToken.address

string

required

Token contract address

Example:

"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

metadata.srcToken.symbol

string

required

Token symbol

Example:

"USDC"

metadata.srcToken.name

string

required

Token name

Example:

"USD Coin"

metadata.srcToken.decimals

number

required

Token decimals

Example:

6

metadata.srcToken.metadata

object

required

Show child attributes

metadata.srcToken.metadata.logoURI

string

Token logo URI

Example:

"https://polygonscan.com/token/images/usdc_32.png"

metadata.dstToken

object

required

Token details

Show child attributes

metadata.dstToken.chainId

number

required

Token chain ID

Example:

8453

metadata.dstToken.address

string

required

Token contract address

Example:

"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

metadata.dstToken.symbol

string

required

Token symbol

Example:

"USDC"

metadata.dstToken.name

string

required

Token name

Example:

"USD Coin"

metadata.dstToken.decimals

number

required

Token decimals

Example:

6

metadata.dstToken.metadata

object

required

Show child attributes

metadata.dstToken.metadata.logoURI

string

Token logo URI

Example:

"https://polygonscan.com/token/images/usdc_32.png"

partnerId

string

Optional partner identifier

clientReferenceId

string

Optional client reference identifier for tracking purposes (alphanumeric, hyphens, and underscores only, max 255 chars)

Maximum string length: 255

onramp

object

Optional onramp configuration

Show child attributes

onramp.vendor

enum<string>

Onramp vendor

Available options:

coinbase,

stripe,

stripe-web2

onramp.paymentMethod

string

Payment method for onramp

Example:

""

onramp.country

string

Country code for the user

Example:

"SG"

onramp.redirectUrl

string

URL to redirect after payment

Example:

"https://www.anyspend.com"

creatorAddress

string

Optional address of the order creator

Example:

"0x58241893EF1f86C9fBd8109Cd44Ea961fDb474e1"

Response

Order created successfully

success

boolean

required

Example:

true

message

string

required

Example:

"Created order successfully"

data

object

required

Base order fields

Show child attributes

data.id

string<uuid>

required

Unique order identifier

Example:

"5392f7a7-d472-4d6b-9848-bd07117fb82d"

data.recipientAddress

string

required

Address to receive tokens/NFT/etc

Example:

"0xb34facb90a200251318e8841c05102366f2158cf"

data.globalAddress

string

required

Global wallet address handling the order

Example:

"0xa640beaa78eeb64bb269f2baf8202b9a7316e123"

data.srcChain

number

required

Source chain ID

Example:

8453

data.dstChain

number

required

Destination chain ID

Example:

8453

data.srcTokenAddress

string

required

Source token contract address

Example:

"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"

data.dstTokenAddress

string

required

Destination token contract address

Example:

"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"

data.srcAmount

string

required

Source amount

Example:

"93354000"

data.status

enum<string>

required

Current order status

Available options:

scanning_deposit_transaction,

waiting_stripe_payment,

expired,

sending_token_from_vault,

relay,

executing,

executed,

refunding,

refunded,

failure

Example:

"executed"

data.errorDetails

string | null

required

Error details if order failed

data.createdAt

number

required

Creation timestamp

Example:

1752505794679

data.expiredAt

number

required

Expiration timestamp

Example:

1752506694679

data.filledAt

number | null

required

Timestamp when the order was filled/executed

data.receivedDepositAt

number | null

required

Timestamp when the deposit was received

data.creatorAddress

string | null

required

Optional creator address

Example:

"0xb34facb90a200251318e8841c05102366f2158cf"

data.partnerId

string | null

required

Optional partner identifier

data.onrampMetadata

object

required

Onramp configuration if used

Show child attributes

data.onrampMetadata.country

string

required

Country code

Example:

"US"

data.onrampMetadata.vendor

enum<string>

required

Onramp vendor used

Available options:

coinbase,

stripe,

stripe-web2

Example:

"stripe-web2"

data.onrampMetadata.paymentMethod

string

required

Payment method used

Example:

""

data.onrampMetadata.redirectUrl

string

required

Redirect URL after payment

Example:

"https://www.anyspend.com"

data.onrampMetadata.stripeAmountInCents

number

Stripe payment amount in cents

Example:

9900

data.onrampMetadata.ipAddress

string<ipv4>

Optional IP address for location detection. Required for Stripe onramp requests in production and omitted from standard order responses.

Example:

"192.168.1.1"

data.onrampMetadata.fingerprint

object

Optional fingerprint data for fraud detection

Show child attributes

data.onrampMetadata.fingerprint.requestId

string

required

Fingerprint request ID

Example:

"fp_req_12345"

data.onrampMetadata.fingerprint.visitorId

string

required

Fingerprint visitor ID

Example:

"fp_visitor_67890"

data.oneClickBuyUrl

string | null

required

Quick purchase URL if available

data.stripePaymentIntentId

string | null

required

Stripe payment intent ID if using Stripe

Example:

"pi_3Rko0sJnoDg53PsP0PDLsHkR"

data.settlement

object

required

Settlement information for executed orders

Show child attributes

data.settlement.actualDstAmount

string

Actual received amount after execution (only for swap/hypeduel orders). Optional - only present for swap/hypeduel orders.

Example:

"990000"

data.settlement.relay

object

Complete relay API response data. Contains transaction details, state changes, fees, and execution status. Optional - can be backfilled by querying Relay API /requests/v2 endpoint.

Example:

{
  "status": "success",
  "metadata": { "currencyOut": { "amount": "990000" } }
}

data.type

enum<string>

required

Order type

Available options:

swap

data.payload

object

required

Swap-specific payload

Show child attributes

data.payload.expectedDstAmount

string

required

Expected amount of destination tokens

Example:

"990000"

data.metadata

object

required

Swap metadata for display purposes

Show child attributes

data.metadata.srcToken

object

required

Token details

Show child attributes

data.metadata.srcToken.chainId

number

required

Token chain ID

Example:

8453

data.metadata.srcToken.address

string

required

Token contract address

Example:

"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

data.metadata.srcToken.symbol

string

required

Token symbol

Example:

"USDC"

data.metadata.srcToken.name

string

required

Token name

Example:

"USD Coin"

data.metadata.srcToken.decimals

number

required

Token decimals

Example:

6

data.metadata.srcToken.metadata

object

required

Show child attributes

data.metadata.srcToken.metadata.logoURI

string

Token logo URI

Example:

"https://polygonscan.com/token/images/usdc_32.png"

data.metadata.dstToken

object

required

Token details

Show child attributes

data.metadata.dstToken.chainId

number

required

Token chain ID

Example:

8453

data.metadata.dstToken.address

string

required

Token contract address

Example:

"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

data.metadata.dstToken.symbol

string

required

Token symbol

Example:

"USDC"

data.metadata.dstToken.name

string

required

Token name

Example:

"USD Coin"

data.metadata.dstToken.decimals

number

required

Token decimals

Example:

6

data.metadata.dstToken.metadata

object

required

Show child attributes

data.metadata.dstToken.metadata.logoURI

string

Token logo URI

Example:

"https://polygonscan.com/token/images/usdc_32.png"

data.clientReferenceId

string | null

Optional client reference identifier for tracking purposes (alphanumeric, hyphens, and underscores only, max 255 chars)

Maximum string length: 255

data.fee

object

Fee structure for the order including Stripe and AnySpend fees

Option 1
Option 2

Show child attributes

data.fee.type

enum<string>

required

Fee type identifier

Available options:

standard_fee

data.fee.feeVersion

number

required

Fee version number

Example:

1

data.fee.tokenToCheckBalance

string

required

Token contract address used to check balance for whale discount (B3 token)

Example:

"0xb3b32f9f8827d4634fe7d973fa1034ec9fddb3b3"

data.fee.recipientBalance

string

required

Recipient's B3 token balance

Example:

"302843673392800000000000"

data.fee.anyspendFeeBps

number

required

AnySpend base fee in basis points before discounts

Example:

80

data.fee.anyspendWhaleDiscountBps

number

required

Whale discount in basis points based on B3 balance

Example:

5000

data.fee.anyspendPartnerDiscountBps

number

required

Partner discount in basis points

Example:

0

data.fee.finalFeeBps

number

required

Final fee in basis points after all discounts applied

Example:

40

statusCode

number

required

Example:

200

Get orders by creator Get order and transactions

⌘I

Getting Started

Token

x402

React

REST API

Advanced

Create a new order

Body

Response