Skip to content
Spritz API Docs

List on-ramps

GET
/v1/on-ramps/

Returns a paginated list of on-ramps for the authenticated user.

On-ramps represent fiat-to-crypto conversion transactions where fiat was sent and crypto was or will be received at a destination address.

Filtering:

  • network: Filter by blockchain network (ethereum, polygon, etc.)
  • token: Filter by output token (case-insensitive, e.g., “usdc”)
  • address: Filter by payout address

Sorting:

  • sort=desc (default): Newest first
  • sort=asc: Oldest first

Pagination: Use cursor-based pagination with the cursor parameter.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
limit
Any of:
string format: numeric
0
cursor

Opaque cursor for pagination. Use the nextCursor value from the previous response.

string
network
string
Allowed values: ethereum polygon base arbitrum avalanche optimism solana tron bitcoin
token

Filter by output token. Case-insensitive (transformed to uppercase).

string
<= 10 characters
address

Filter by payout address

string
<= 256 characters
sort
string
Allowed values: desc asc

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Response for status 200

object
data
required
Array<object>
object
id
required

Unique on-ramp identifier

string
status
required
string
Allowed values: awaiting_payment processing completed cancelled refunded in_review
createdAt
required
string format: date-time
input
required
object
amount
required

Fiat amount sent (after fees)

string
currency
required
string
Allowed values: USD CAD EUR GBP
rail
required
string
Allowed values: ach_push wire_push sepa_push
fees
required
object
amount
required

Fee in source currency

string
currency
required

Currency of the fee paid

string
output
object
amount
required

Crypto amount received

string
token
required

Token received

string
network
required
string
Allowed values: ethereum polygon base arbitrum avalanche optimism solana tron bitcoin
address
required

Destination wallet address

string
txHash

Blockchain transaction hash

string
completedAt
string format: date-time
hasMore
required

Whether there are more results

boolean
nextCursor

Cursor for fetching the next page

string

401

Section titled “401 ”

Response for status 401

object
type

A URI reference that identifies the problem type

string
default: about:blank
title
required

A short, human-readable summary of the problem type

string
status
required

The HTTP status code

number
detail

A human-readable explanation specific to this occurrence

string
instance

A URI reference that identifies the specific occurrence

string
realm

The authentication realm

string
scope

The required scope for this resource

string

404

Section titled “404 ”

Response for status 404

object
type

A URI reference that identifies the problem type

string
default: about:blank
title
required

A short, human-readable summary of the problem type

string
status
required

The HTTP status code

number
detail

A human-readable explanation specific to this occurrence

string
instance

A URI reference that identifies the specific occurrence

string
resourceType
required

The type of resource that was not found

string
resourceId
required

The identifier of the resource that was not found

string

500

Section titled “500 ”

Response for status 500

object
type

A URI reference that identifies the problem type

string
default: about:blank
title
required

A short, human-readable summary of the problem type

string
status
required

The HTTP status code

number
detail

A human-readable explanation specific to this occurrence

string
instance

A URI reference that identifies the specific occurrence

string