Chains
Assets
curl --request GET \
--url https://v2.prod.halliday.xyz/payments/history \
--header 'Authorization: Bearer <token>'{
"payment_statuses": [
{
"payment_id": "<string>",
"status": "COMPLETE",
"funded": true,
"created_at": "2025-11-12T20:15:30.000Z",
"updated_at": "2025-11-12T20:25:45.000Z",
"initiate_fund_by": "2025-11-12T21:15:30.000Z",
"completed_at": "2025-11-12T20:25:45.000Z",
"quoted": {
"output_amount": {
"asset": "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"amount": "100.00"
},
"fees": {
"total_fees": "3.50",
"conversion_fees": "2.00",
"network_fees": "1.00",
"business_fees": "0.50",
"currency_symbol": "USD"
},
"onramp": "stripe",
"onramp_method": "credit_card",
"route": [
{
"type": "ONRAMP",
"net_effect": {
"consume": [
{
"account": "USER",
"resource": {
"asset": "usd",
"property": "BALANCE"
},
"amount": {
"amount": "103.50"
}
}
],
"produce": [
{
"account": "PROCESSING_ADDRESS",
"resource": {
"asset": "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"property": "BALANCE"
},
"amount": {
"amount": "100.00"
}
}
]
},
"pieces_info": [
{
"type": "onramp"
}
],
"step_index": 0
}
]
},
"fulfilled": {
"output_amount": {
"asset": "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"amount": "100.00"
},
"fees": {
"total_fees": "3.50",
"conversion_fees": "2.00",
"network_fees": "1.00",
"business_fees": "0.50",
"currency_symbol": "USD"
},
"onramp": "stripe",
"onramp_method": "credit_card",
"route": [
{
"status": "COMPLETE",
"type": "ONRAMP",
"net_effect": {
"consume": [
{
"account": "USER",
"resource": {
"asset": "usd",
"property": "BALANCE"
},
"amount": {
"amount": "103.50"
}
}
],
"produce": [
{
"account": "PROCESSING_ADDRESS",
"resource": {
"asset": "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"property": "BALANCE"
},
"amount": {
"amount": "100.00"
}
}
]
},
"pieces_info": [
{
"type": "onramp"
}
],
"step_index": 0,
"transaction_hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
}
]
},
"current_prices": {
"USD": "1.00",
"ethereum:0x": "4200.00",
"ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "1.00"
},
"price_currency": "USD",
"processing_addresses": [
{
"chain": "ethereum",
"address": "0xaddress..."
}
],
"owner_address": "0xowner...",
"destination_address": "0xdest..."
}
],
"next_pagination_key": "42ff9b02-037f-4a90-87fb-a4d2ca128565_2025-11-12T22:08:52.517Z"
}Get payment history
Retrieve a paginated list of payment statuses filtered by owner. Returns an array of payment status objects and a pagination key for fetching the next page.
curl --request GET \
--url https://v2.prod.halliday.xyz/payments/history \
--header 'Authorization: Bearer <token>'{
"payment_statuses": [
{
"payment_id": "<string>",
"status": "COMPLETE",
"funded": true,
"created_at": "2025-11-12T20:15:30.000Z",
"updated_at": "2025-11-12T20:25:45.000Z",
"initiate_fund_by": "2025-11-12T21:15:30.000Z",
"completed_at": "2025-11-12T20:25:45.000Z",
"quoted": {
"output_amount": {
"asset": "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"amount": "100.00"
},
"fees": {
"total_fees": "3.50",
"conversion_fees": "2.00",
"network_fees": "1.00",
"business_fees": "0.50",
"currency_symbol": "USD"
},
"onramp": "stripe",
"onramp_method": "credit_card",
"route": [
{
"type": "ONRAMP",
"net_effect": {
"consume": [
{
"account": "USER",
"resource": {
"asset": "usd",
"property": "BALANCE"
},
"amount": {
"amount": "103.50"
}
}
],
"produce": [
{
"account": "PROCESSING_ADDRESS",
"resource": {
"asset": "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"property": "BALANCE"
},
"amount": {
"amount": "100.00"
}
}
]
},
"pieces_info": [
{
"type": "onramp"
}
],
"step_index": 0
}
]
},
"fulfilled": {
"output_amount": {
"asset": "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"amount": "100.00"
},
"fees": {
"total_fees": "3.50",
"conversion_fees": "2.00",
"network_fees": "1.00",
"business_fees": "0.50",
"currency_symbol": "USD"
},
"onramp": "stripe",
"onramp_method": "credit_card",
"route": [
{
"status": "COMPLETE",
"type": "ONRAMP",
"net_effect": {
"consume": [
{
"account": "USER",
"resource": {
"asset": "usd",
"property": "BALANCE"
},
"amount": {
"amount": "103.50"
}
}
],
"produce": [
{
"account": "PROCESSING_ADDRESS",
"resource": {
"asset": "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"property": "BALANCE"
},
"amount": {
"amount": "100.00"
}
}
]
},
"pieces_info": [
{
"type": "onramp"
}
],
"step_index": 0,
"transaction_hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
}
]
},
"current_prices": {
"USD": "1.00",
"ethereum:0x": "4200.00",
"ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "1.00"
},
"price_currency": "USD",
"processing_addresses": [
{
"chain": "ethereum",
"address": "0xaddress..."
}
],
"owner_address": "0xowner...",
"destination_address": "0xdest..."
}
],
"next_pagination_key": "42ff9b02-037f-4a90-87fb-a4d2ca128565_2025-11-12T22:08:52.517Z"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Owner address to filter payments by
Pagination key from previous response to fetch next page
Maximum number of results to return
Filter payments by category
ALL, NEW_OR_FUNDED Response
Payment history retrieved successfully
Array of payment status objects
Show child attributes
Show child attributes
PENDING, COMPLETE, FAILED, EXPIRED, WITHDRAWN, TAINTED Whether the payment has been funded
Deadline for funding the payment.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Identifier in the token format ("chain:address") or fiat currency code ("USD")
"ethereum:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
Amount as a string to preserve precision
"1"
Show child attributes
Show child attributes
Total fees amount
Ramps + bridge + DEX fees
Blockchain gas fees
Developer integration fees
Currency symbol that the fees are denominated in (e.g., "USD", "USDC")
"USD"
Quoted workflow steps and their effects
Show child attributes
Show child attributes
ONRAMP, ONCHAIN_STEP, USER_FUND Show child attributes
Show child attributes
Show child attributes
Show child attributes
USER, DEST, HALLIDAY, PROCESSING_ADDRESS, REV_SHARE, BRIDGE Show child attributes
Show child attributes
USER, DEST, HALLIDAY, PROCESSING_ADDRESS, REV_SHARE, BRIDGE Onramp provider name
Payment method
"credit_card"
Show child attributes
Show child attributes
In-progress workflow steps, statuses, and their effects
Show child attributes
Show child attributes
PENDING, COMPLETE, UNREACHABLE, FAILED ONRAMP, ONCHAIN_STEP, USER_FUND Show child attributes
Show child attributes
Show child attributes
Show child attributes
USER, DEST, HALLIDAY, PROCESSING_ADDRESS, REV_SHARE, BRIDGE Show child attributes
Show child attributes
USER, DEST, HALLIDAY, PROCESSING_ADDRESS, REV_SHARE, BRIDGE Blockchain transaction hash for the step
Show child attributes
Show child attributes
Identifier in the token format ("chain:address") or fiat currency code ("USD")
"ethereum:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
Amount as a string to preserve precision
"1"
Show child attributes
Show child attributes
Total fees amount
Ramps + bridge + DEX fees
Blockchain gas fees
Developer integration fees
Currency symbol that the fees are denominated in (e.g., "USD", "USDC")
"USD"
Onramp provider name
Payment method
"credit_card"
Currency that all prices are denominated in
"USD"
Address of the owner of the payment
Address of the destination of the payment
Optional reference to the original quote request.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
FIXED_INPUT Show child attributes
Show child attributes
Identifier in the token format ("chain:address") or fiat currency code ("USD")
"ethereum:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
Amount as a string to preserve precision
"1"
Identifier in the token format ("chain:address") or fiat currency code ("USD")
"ethereum:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
Currency that all prices are denominated in
"USD"
Filter by specific onramp providers
["moonpay", "coinbase"]Filter by onramp payment methods
["credit_card", "ach", "apple_pay"]IP address of the customer
Customer ID for tracking
Geolocation information
Optional parent payment identifier used when creating a quote from an existing payment.
ID of the customer who created the payment
Instruction payload that returns the funding pages if the payment requires funding.
Show child attributes
Show child attributes
Discriminator for this instruction type.
ONRAMP, TRANSFER_IN The payment this instruction is associated with.
URL where the user can complete funding for this payment.
One or more deposit routes to fund the payment.
Show child attributes
Show child attributes
Identifier in the token format ("chain:address") or fiat currency code ("USD")
"ethereum:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
Amount to deposit, as a decimal string.
"4.8"
Address to which funds will be deposited.
Network on which the deposit will be made (e.g., base, ethereum).
"base"
{
"type": "ONRAMP",
"payment_id": "<string>",
"funding_page_url": "https://app.halliday.xyz/funding/${payment_id}",
"deposit_info": [
{
"deposit_token": "base:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
"deposit_amount": "4.8",
"deposit_address": "0xaddress",
"deposit_chain": "base"
}
]
}Pagination key to fetch the next page of results
"42ff9b02-037f-4a90-87fb-a4d2ca128565_2025-11-12T22:08:52.517Z"