> ## Documentation Index
> Fetch the complete documentation index at: https://getequity.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Buy token

> Allows an api client purchase token on the GE platform

**id** `string` *required*

The id of the token to buy

**amount** `integer` *required*

The quantity of token to buy

**price** `integer` *required*

The price per unit of each token

**currency** `string` *required*

The currency to use for the transaction. It must be one of the following: `USD`, `NGN`,`KES`

**customer** `object` *required*

Object containing customer details

**meta** `object`

Object containing additional information like `tokens` and `amount`

```json theme={null}
{
    "amount": 20,
    "price": 10,
    "currency": "USD",
    "customer": {
        "name": "Rema divine1",
        "email": "rema2@yopmail.com"
    },
    "meta": {   
        "tokens": 2
    }
}
```

```json theme={null}
{
  "status": "success",
  "message": "Buy order is being processed",
  "data": null
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.