Skip to main content
Explore available investment options by retrieving detailed fund information including trading status, documents, and pricing data for your distributor platform.

Getting Started

This guide walks you through retrieving fund information using the Rime API. You’ll make your first successful API call to access fund data and understand how to filter and explore available investment options for your distributor platform.

Prerequisites

Before retrieving fund information, ensure you have:
  1. Authentication token - Follow our authentication guide to get your access token
  2. Basic understanding of fund concepts - ISINs, share classes, and trading flags

Step-by-Step Implementation

Step 1: List all available funds

Start by retrieving a list of all available funds to explore investment options for your distributor platform:
curl -X GET "https://sandbox.api.rime.finance/v1/funds?limit=100&skip=0" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}" \
  -H "Content-Type: application/json"

Step 2: Get information on a specific fund

Retrieve comprehensive information about a specific fund using its abbreviation:
curl -X GET "https://sandbox.api.rime.finance/v1/funds/JPMA" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}" \
  -H "Content-Type: application/json"

Step 3: Handle the response

A successful fund data retrieval returns a 200 OK status with detailed fund information:
200
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "AltAccess JP Morgan Multi-Alternatives Fund",
  "abbreviation": "JPMA",
  "description": "A diversified alternatives fund providing exposure to multiple alternative investment strategies",
  "target_fund_name": "JP Morgan Multi-Alternatives Fund",
  "target_fund_volume": 2500000000.0,
  "target_fund_jurisdiction": "LU",
  "risk_score": 7,
  "recommended_holding_duration": 36,
  "feeder_fund_volume": 150000000.0,
  "feeder_fund_location": "Netherlands",
  "nav_frequency": "monthly",
  "strategy": "Multi-manager alternatives platform",
  "base_currency": "EUR",
  "distribution_strategy": "accumulating",
  "payment_type": "sepa",
  "payment_account_holder_name": "AltAccess Fund Services B.V.",
  "payment_iban": "NL91ABNA0417164300",
  "payment_is_active": true,
  "documents": [
    {
      "id": "doc-550e8400-e29b-41d4-a716-446655440000",
      "url": "https://docs.rime.finance/funds/JPMA/prospectus.pdf?expires=1640995200&signature=abc123",
      "type": "FEEDER_FUND"
    }
  ],
  "created": "2024-01-15T10:30:00Z"
}

Filtering funds by criteria

Narrow down your search using specific criteria like fund properties:
curl -X GET "https://sandbox.api.rime.finance/v1/funds?base_currency=EUR&risk_score=7" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}" \
  -H "Content-Type: application/json"

Troubleshooting

Cause: Invalid isin or fund doesn’t existSolution: Verify the isin by listing available funds first
{
  "detail": "Fund data not found"
}
Cause: Missing or invalid authentication tokenSolution: Ensure you have a valid access token from the authentication process
{
  "detail": "Could not validate credentials"
}
Cause: Invalid query parameters or incorrect data typesSolution: Check parameter types and ensure boolean values are properly formatted
{
  "detail": [
    {
      "loc": ["query", "subscribable"],
      "msg": "value could not be parsed to a boolean",
      "type": "type_error.bool"
    }
  ]
}

Next Steps

After retrieving fund information, you can:
  1. Get portfolio information - View existing fund holdings and account balances
  2. Buy shares - Purchase fund units for your accounts
  3. Sell shares - Sell existing fund holdings
I